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Xanden， 这 本 书 是 送 你 的 礼物 ， 想 不 到 吧 ! 





译 者 序 





与 其 他 语言 相 比 ，Java 最 大 的 优势 或 许 在 于 完善 的 生态 系统 : 开发 者 所 需要 的 一 切 ， 几 乎 
都 能 从 这 个 生态 系统 中 找到 。 世 界 上 累计 有 150 亿 台 设备 运行 Java， 全 球 Java 开发 者 的 数 
量 超过 1000 万 人 ，Java 不 仅 构成 了 大 量 开源 平台 的 基础 ， 也 已 成 为 软件 文化 中 不 可 或 缺 
的 一 部 分 。 


然而 ， 作 为 一 门 诞 生 于 1995 年 的 语言 ， 运 行 环境 腔 肿 、 代 码 库 庞大 等 问题 逐渐 成 为 制约 
Java 发 展 的 瓶颈。 对 于 稳定 性 与 兼容 性 的 顾虑 ， 使 得 这 门 语言 越 来 越 难 以 大 刀 阔 其 地 改 
革 。 相 当 一 部 分 业务 服务 仍然 采用 Java 8 之 前 的 版 本 构建 ， 复 杂 的 系统 升级 往往 令 维护 人 
员 望 而 却步 。 并 非 企业 不 想 求 变 ， 而 是 求 变 的 代价 在 某 些 时 候 显得 异常 高 昂 。 


上 且 Oracle 从 未 停止 探索 的 脚步 ，Java 9 的 发 布 或 许可 以 视 作 Java 平台 求 变 的 开始 。 尽 管 社 
区 对 Jigsaw 项 目 褒贬 不 一 ， 模 块 化 系统 的 意义 仍然 有 待 时 间 检 验 ， 不 过 Oracle 意欲 求 变 的 
决心 由 此 可 见 一 斑 。 而 在 Java 9 面世 之 后 ，Oracle 加 快 了 这 门 语 言 的 迭代 速度 ， 版 本 发 布 
周期 改 为 半年 一 次 ， 以 便 缩短 开发 者 使 用 新 功能 的 时 间 。Java 的 发 布 速度 经 常 受到 诉 病 ， 
这 种 改变 或 许 有 助 于 解决 这 个 问题 。 
硬件 厂商 同样 在 探索 前 行 。 作 为 JavaOne 2017 赞助 商 之 一 的 英特尔 在 向 量 计算 领域 投入 大 
量 精力 ， 发 布 了 有 助 于 Java API 充分 利用 硬件 向 量 计 算 性 能 的 Vector API。 在 推动 整个 生 
态 系 统 发 展 方面 ，JavaOne 功 不 可 没 。 


在 软件 工程 师 的 职业 生涯 中 ， 知 识 的 “半衰期 ”通常 为 三 年 ， 这 意味 着 我 们 掌握 的 一 半 
知识 在 三 年 后 将 变 得 毫 无 价值 。 但 这 个 行业 本 身 就 意味 着 不 断 充电 与 持续 学 习 ， 技 术 大 
会 或 许 是 了 解 行业 现状 的 有 效 途 径 。 本 书 的 诞生 即 源 于 NFJS 六 回 研讨 会 对 作者 的 局 发 。 
NFJS 始 于 2001 年 ， 主 要 关注 软件 开发 领域 出 现 的 最 新 技术 ，Java 与 JVM 是 其 中 重点 讨 
论 的 话题 。 

不 过 对 Java 开发 者 而 言 ， 掌 握 这 门 语 言 的 各 种 技巧 至 关 重 要 ， 夯 实 基础 始终 是 首要 任务 。 
本 书 沿 交 了 O’Reilly Media“ 编 程 食谱 书 ” 的 一 贯 风 格 ， 将 提炼 自 实 际 开 发 的 问题 以 范例 
的 形式 展现 给 读者 ， 使 开发 者 对 Java 的 关键 知识 点 了 然 于 心 。O'Reilly Media 以 出 版 技术 
类 图 书 著称 ， 其 “动物 书 ” 系 列 与 Manning Publications 的 “服饰 书 ” 系 列 备 受 开发 人 员 的 
推 党 。 
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毫 无 疑问 ，Java 8 引入 的 新 特性 (特别 是 lambda 表达 式 和 Stream API) 让 这 门 语言 经 历 了 
一 次 巨大 的 飞跃 。 多 年 来 ， 我 一 直 是 Java 8 的 忠实 用 户 ， 并 在 各 种 会 议 、 研 讨 会 以 及 博客 
上 不 遗 余力 地 向 开发 人 员 介 绍 这 些 新 特性 。 我 很 清楚 ， 尽 管 lambda 表达 式 和 流 让 Java 具 
备 了 更 多 函数 式 编 程 的 特点 〈 并 行 处 理 的 威力 也 得 以 发 挥 )， 不 过 它们 并 非 吸引 开发 人 员 
的 真正 原因 。 新 的 习惯 用 法 能 让 解决 特定 问题 变 得 更 为 简单 和 高 效 ， 这 才 是 Java 8 备 受 追 
捧 的 根源 所 在 。 
作为 一 名 程序 员 、 演 讲 者 和 撰 稿 人 ， 我 不仅 希望 其 他 开发 人 员 注 意 到 Java 语言 的 演变 ， 还 
希望 能 展示 这 些 演变 是 如 何 提高 工作 效率 的 。 我 们 可 以 采用 更 简单 的 方法 解决 问题 ， 甚 至 
还 能 解决 不 同类 型 的 问题 。 我 之 所 以 欣赏 本 书 作 者 Ken Kousen 的 工作 ， 是 因为 他 在 写作 
时 严格 遵循 以 下 原则 : 帮助 读者 获取 新 知识 ， 避 免 将 时 间 花 在 已 经 了 解 或 不 需要 的 细节 
上 。Ken 专注 于 对 一 线 开发 人 员 有 价值 的 那些 技术 。 


我 第 一 次 接触 到 Ken 的 工作 ， 是 他 在 JavaOne 2013 会 议 上 发 表 题 为 “Making Java Groovy: 
Simplify Your Java Development with Groovy” 的 演讲 时 。 那 时 ， 我 所 在 的 团队 正在 为 编写 
易 读 且 有 用 的 测试 而 莘 精 竟 虚 ， 我 们 所 考虑 的 一 种 解决 方案 正 是 Groovy。 作 为 一 名 长 期 
使 用 Java 的 程序 员 ， 我 不 愿意 为 了 编写 测试 而 去 学 习 一 门 全 新 的 语言 ， 特 别 是 我 自 认 为 
已 经 了 解 如 何 编写 测试 时 。 然 而 ， 聆 听 Ken 为 Java 程序 员 所 做 的 Groovy 介绍 让 我 受益 菲 
浅 ， 他 并 未 重复 那些 我 已 烂熟 于 心 的 内 容 ， 而 是 直 和 正题， 使 我 迅速 掌握 了 许多 所 需 的 知 
识 。 我 意识 到 ， 选 择 合 适 的 学 习 材 料 能 极 大 地 提高 学 习 效 率 ， 我 不 必 为 了 一 个 环节 的 应 用 
而 将 一 门 语言 的 细 枝 未 节 全 部 吃透 。 因 此 ， 我 立即 购买 了 Ken 撰写 的 Making Java Groovy 
ER 

本 书 延 续 了 类 似 的 主题 。 作 为 经 验 丰 富 的 开发 者 ， 我 们 无 须 像 初学 者 一 样 学 习 Java 8 和 
Java 9 引入 的 所 有 新 特性 ， 也 没有 时 间 这 样 做。 我 们 需要 的 是 一 本 能 迅速 查找 相关 特性 介 
绍 的 指南 ， 并 给 出 可 以 用 于 实际 开发 的 示例 。 本 书 就 是 这 样 一 本 指南 。 书 中 范例 来 自 开发 
人 员 在 日 常 工作 中 遇 到 的 问题 ， 并 介绍 了 如 何 利用 Java 8 和 Java 9 的 新 特性 解决 这 些 问 


































































































注 1: 该 书 由 Manning Publications 于 2013 年 9 月 出 版 ，Ken 在 JavaOne 2013 会 议 上 的 演讲 即 以 此 为 题 。 
一 一 译 者 注 
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题 ， 从 而 以 更 自然 的 方式 让 开发 人 员 对 这 门 语言 的 变化 了 然 于 心 。 我 们 可 以 举一反三 ， 将 
所 学 的 知识 运用 到 实际 开发 中 。 


即便 是 Java 8 和 Java 9 的 长 期 使 用 者 ， 依 然 可 以 从 本 书 中 受到 启发 。 有 关 归 约 运 算 符 的 
讨论 切实 加 深 了 我 对 这 种 函数 式 编程 风格 的 理解 ， 而 且 我 也 无 须 重新 理 清 思路 。 专 门 探讨 
Java 9 新 特性 的 章节 正 是 开发 人 员 所 需要 的 ， 这 些 新 特性 尚未 广为人知 。 本 书 提供 了 一 种 
很 好 的 方法 ， 能 够 帮助 读者 快速 有 效 地 了 解 Java 的 最 新 发 展 。 对 所 有 希望 提高 自身 知识 水 
平 的 Java 开发 人 员 而 言 ， 本 书 堪 称 良师益友 。 


























Trisha Gee 
Java Champion 


JetBrains 公司 Java 布道 师 
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到 
Ml 


与 时 俱 进 的 Java 


有 时候 ， 很 难 相信 一 门 已 保持 了 20 年 向 后 兼容 性 的 语言 会 发 生 如 此 巨大 的 变化 。 在 Oracle 
于 2014 年 3 月 发 布 Java SE 8 之 前 ， 作 为 最 权威 的 服务 器 端 编程 语言 ，Java 已 然 赢 得 “21 
世纪 的 COBOL” 这 一 美誉 。Java 稳定 且 应 用 广泛 ， 同 时 还 不 遗 余力 地 追求 性 能 。 变 化 来 
得 很 慢 ， 但 还 是 来 了 。 正 因为 如 此 ， 每 当 Java 发 布 新 版 本 时 ， 企 业 的 升级 意愿 并 不 迫切 。 


不 过 ,在 Java SE 8 发 布 之 后 ， 一 切 都 发 生 了 改变 。Java SE 8 将 “Lambda 项目 ”(Project 
Lambda) 纳入 其 中 ， 这 个 重大 的 创新 将 函数 式 编程 (functional programming) 的 概念 引入 
这 门 杰 出 的 面向 对 象 语言 。lambda 表达 式 、 方 法 引用 以 及 流 从 根本 上 改变 了 Java 的 习惯 
用 法 。 自 此 之 后 ， 开 发 人 员 一 直 在 努力 跟 上 这 门 语言 前 进 的 步伐 。 

本 书 无 意 评判 这 些 变 化 能 否 对 Java 开发 有 所 促进 ， 也 无 意 探 讨 是 否 可 以 通过 其 他 途径 实现 
同样 的 目的 。 本 书 只 是 告诉 读者 ， 新 特性 已 经 存在 ， 我 们 应 该 如 何 利用 它们 完成 工作 。 这 
也 是 本 书 采用 范例 形式 编写 的 原因 。 读 者 可 以 根据 需要 阅读 本 书 ， 了 解 Java 引入 的 新 特性 
将 如 何 帮助 自己 实现 既定 目标 。 

换言之 ,一旦 掌握 这 种 新 的 程序 设计 模型 ， 就 能 享受 它 所 带 来 的 诸多 优点 。 函 数 式 代码 往 
往 更 简单 ， 而 且 更 易于 编写 和 理解 。 函 数 式 编程 强调 不 可 变性 (immutability)， 这 使 得 编 
写 的 并 发 代码 更 简洁 ， 调 试 和 运行 更 容易 成 功 。 在 Java 初 登 舞 台 时 ， 摩 尔 定律 仍然 有 效 : 
处 理 器 的 速度 大 约 每 18 个 月 就 提高 一 倍 。 而 如 今 性 能 提升 的 根本 在 于 ， 即 使 是 手机 也 已 
大 部 分 配备 了 多 个 处 理 器 。 

由 于 Java 非常 注重 保持 向 后 兼容 性 ， 不 少 企 业 和 开发 人 员 在 迁移 到 Java SE 8 时 并 未 采用 
新 的 习惯 用 法 。 即 便 如 此 ，Java SE 8 仍然 是 一 个 值得 尝试 的 强大 平台 ,而且 Oracle 已 于 
2015 年 4 月 正式 宣布 停止 对 Java 7 提供 支持 。 


Java SE 8 发 布 至 今 已 有 几 年 时 间 ， 大 部 分 Java 开发 人 员 目 前 都 已 转向 JDK 8。 现 在 , 深入 
了 解 Java SE 8 对 未 来 开发 的 意义 和 影响 正当 其 时 。 和 希望 本 书 能 让 这 一 过 程 变 得 更 加 容易 。 
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目标 读者 





本 和 

会 讨论 某 些 较 早 的 概念 ， 但 本 
读者 已 使 用 Java 玫 
本 书 涵盖 与 Java SE 8 有 关 的 几乎 所 有 内 容 ， 
望 了 解 Java SE 8 新 增 的 函数 式 习 惯用 法 将 刀 
的 教程 是 一 个 不 错 的 选择 。 





pb 





























F 发 过 项 目 ， 并 且 熟 悉 标 准 库 ， 阅 读本 书 时 应 该 不 会 感到 困 


范例 假定 读者 对 Java SE 8 之 前 的 版 本 已 有 所 了 解 。 尽 管 不 要 求 读者 精通 Java， 书 中 
FEE 一 本 针对 初学 者 的 Java 或 面向 对 象 编程 教程 。 如 果 

















难 。 


并 专门 有 一 章 介绍 Java 9 的 新 特性 。 如 果 和 希 
上 何 改变 代码 的 编写 方式 ， 这 本 包含 丰富 用 例 




















Java 广泛 应 用 于 服务 器 端 开发 ， 拥 有 丰富 的 开源 库 和 工具 支持 系统 。Spring 和 Hibernate 是 


两 种 最 流行 的 玫 





F 源 框架 ， 二 者 只 支持 (或 很 快 将 


只 支持 ) Java 8 及 以 上 的 版 本 。 如 果 读 者 





计划 使 用 Java 8 或 Java 9 进行 开发 ， 本 书 讨论 的 范例 或 许 能 有 所 局 发。 


本 书 结构 


本 书 以 范例 的 形式 编写 和 组 织 内 容 。 但 在 讨论 涉及 lambda 表达 式 、 方 法 引用 以 及 流 的 范 
例 时 ， 有 时 也 会 涉及 其 他 内 容 。 因 此 ， 前 6 章 将 介绍 相关 概念 ， 不 过 读者 无 须 以 任何 特定 





的 顺序 阅读 。 
各 章 主要 内 容 如 下 。 





认 方 法 和 静态 方法 。 此 外 ， 还 将 定义 “ 
的 重要 性 。 





第 1 章 将 介绍 lambda 表达 式 和 方法 引用 的 基础 知识 ， 然 后 讨论 接口 的 新 特性 ， 包 括 默 
国 数 式 接口 ”， 并 解释 它 对 于 理解 lambda 表达 式 


第 2 章 主 要 介绍 Java8 引入 的 java.util.function 包 ， 它 包括 Consumer、Supplier、Predicate 





以 及 Function 这 四 类 特殊 的 函数 式 接口 ， 
第 3 章 将 介绍 流 
地 进行 处 理 。 

介绍 的 并 行 和 并 发 有 密切 的 关系 。 














第 4 章 主要 介绍 流 数 据 的 排序 ， 并 讨论 如 何 将 其 转换 为 集合 。 这 一 章 还 将 介绍 分 
组 ， 它 们 将 一 般 意 义 上 的 数据 库 操作 转换 为 简单 的 库 调用 。 
第 5 章 是 综合 性 的 一 章 。 在 掌握 lambda 表达 式 、 方 法 3 
本 题 。 这 一 章 还 将 讨论 惰性 、 延 迟 执行 、 


它们 的 应 用 贯穿 于 整个 标准 库 。 





的 概念 及 其 表示 抽象 的 方法 。 流 支持 对 数据 进行 转换 和 过 滤 ， 而 非 迭 代 
这 一 章 的 范例 将 讨论 与 流 相关 的 映射 、 过 滤 、 归 约 等 概念 ， 它 们 与 第 9 章 





分 


区 和 











用 以 及 流 的 用 法 之 后 ， 读 者 将 
闭 包 


学 习 如 何 综合 运用 它们 来 解决 某 些 有 趣 的 | 
复合 等 概念 ， 以 及 异常 处 理 这 个 令 人 头疼 的 问题 。 
。 第 6 章 将 讨论 Java 8 引入 的 颇具 争议 性 的 0ptionat 类 。 这 一 章 的 范例 将 介绍 optional 类 





的 用 法 ， 以 及 如 何 创建 实例 并 从 中 提取 值 











。 此 外 ， 我 们 将 进一步 讨论 optionalt 类 中 map 


与 flatMap 操作 所 体现 的 函数 式 概念 ,以 及 它们 与 流 中 的 map 与 flatMap 操作 有 何不 同 。 








第 7 音 | 
录 处 理 为 标准 库 引入 的 一 些 函数 式 概念， 


和 介绍 输入 /输出 流 ( 与 函数 式 流 相 对 ) 的 实际 应 用 ， 以 及 Java 8 针对 文件 和 目 


第 8 章 将 讨论 Java 8 引入 的 Date-Time API， 以 及 它 如何 取 代 传 统 且 饱 受 诉 病 的 Date 类 
和 Calendar 类 。 这 种 新 的 API 基于 Joda-Time 库 ， 


EE 
凝聚 





了 大 量 开发 人 员 多 年 的 使 月 


日 经 








验 , 已 被 重 写 为 java.time 包 。 坦 率 地 讲 , 即 便 Date-Time API 是 Java 8 新 增 的 唯一 特性 ， 


升级 到 Java 8 也 物 有 所 值 。 





。 第 9 章 主 要 介绍 流 模 型 的 一 种 隐 式 承诺 : 通过 一 次 方法 调用 ， 可 以 将 串 行 流转 换 为 并 行 
流 ， 从 而 充分 利用 计算 机 中 所 有 可 用 的 处 理 器 。 并 发 涉及 的 内 容 很 多 ， 这 一 章 将 重点 介 





绍 Java 库 的 新 增 功能 ， 这 些 功 
努力 。 
。 第 10 章 将 介绍 Java 9 引入 的 
Jigsaw 本 身 的 内 容 已 可 单独 成 
他 范例 将 讨论 接口 中 的 私有 方 
方法 ， 以 及 如 何 创 建 日 期 流 。 
。 附录 A 将 介绍 Java 中 的 泛 型 。 








能 便于 用 户 进 行 试验 ， 并 评估 成 本 和 收益 是 否 值得 付出 





众多 新 特性 ， 该 版 本 于 2017 年 9 月 21 日 正式 发 布 。 
上 ， 但 其 基础 概念 十 分 清晰 ， 这 一 章 将 对 此 进行 介绍 。 其 
法 ， 并 介绍 Stream、Collectors 与 Optional 新 增 的 各 种 





泛 型 是 Java 1.5 引入 的 概念 ， 但 大 部 分 开发 人 员 对 泛 型 


只 是 略 知 皮毛 ， 仅 停留 在 完成 工作 所 需 的 层面 上 。 不 过 浏览 Java 8 和 Java 9 的 Javadoc 








就 会 知道 ， 这 种 日 子 已 一 去 不 复 返 。 附 录 A 旨 在 介绍 如 何 阅读 并 解释 API， 以 帮助 读者 


理解 较为 复杂 的 方法 签名 。 


读者 不 必 以 任何 特定 的 顺序 阅读 各 章 及 其 范例 。 各 章 之 间 互 为 补充 ， 而 且 每 个 范例 最 后 
都 包括 指向 其 他 范例 的 参考 信息 ， 所 以 从 任何 地 方 开始 阅读 均 无 不 妥 。 章 节 分 组 是 为 了 





问题 。 


排版 约定 
本 书 使 用 以 下 排版 约定 。 


表示 新 术语 和 重点 强调 的 内 容 。 


。 等 宽 字 体 (constant width) 





将 相近 的 范例 归 类 ， 但 读者 完全 可 以 根据 需要 阅读 所 需 的 范例 ， 以 解决 当前 遇 到 的 任何 


表示 程序 片段 ， 以 及 正文 中 出 现 的 变量 、 函 数 名 、 数 据 库 、 数 据 类 型 、 环 境 变量 、 语 句 


和 关键 词 等 。 





。 加 粗 等 宽 字体 (constant width bold) 
表示 命令 以 及 其 他 需要 用 户 输入 的 文字 。 
。 等 宽 斜 体 (constant width italic) 
表示 这 些 值 应 该 替换 为 用 户 输入 ， 或 根据 上 下 文 确定 。 





该 图 标 表示 提示 或 建议 。 











注 1: 是 的 ， 我 也 希望 能 将 讨论 Java 9 的 章节 排 在 第 9 章 ， 不 过 仅仅 为 了 偶然 的 对 称 性 而 对 章节 进行 重新 编 








排 似 乎 不 太 合 适 。 有 这 个 脚注 也 就 够 了 。 














该 图 标 表 示 一 般 性 说 明 。 











示例 代码 


读者 可 以 从 http://www.ituring.com.cn/book/2032 下 载 本 书 源 代码 ， 它 们 分 别 存 储 Java 8 的 
相关 范例 (第 10 章 除外 )、Java 9 的 相关 范例 以 及 范例 9.7 讨论 的 复杂 示例 ， 且 均 已 配置 
为 包含 测试 与 构建 文件 的 Gradle 项 目 。 

本 书 则 在 帮助 读者 解决 开发 中 过 到 的 问题 。 一 般 而 言 ， 读 者 不 必 获 得 O'Reilly 的 授权 ， 就 
可 以 在 自己 的 程序 或 文档 中 使 用 书 中 的 示例 代码 。 不 过 如 果 需 要 大 量 复制 代码 ， 则 应 该 联 
系 我 们 以 获得 许可 。 例 如 ， 读 者 可 以 直接 在 程序 中 使 用 本 书 的 代码 块 。 但 是 ， 销 售 或 分 发 
O’Reilly 图 书 的 配套 光盘 则 需要 获得 许可 。 引 用 本 书 及 其 示例 代码 来 解答 问题 ， 不 需要 获 
得 许可 。 如 果 在 自己 的 产品 文档 中 大 量 使 用 书 中 的 示例 代码 ， 则 需要 获得 许可 。 

欢迎 读者 在 使 用 本 书 的 示例 代码 时 注 明 出 处 ， 但 这 不 是 强制 要 求 。 通 常 要 注 明 书 名 、 作 
者 、 出 版 社 和 ISBN。 例 如 ,，“Modern Java Recipes by Ken Kousen (O’Reilly). Copyright 2017 
Ken Kousen, 978-0-491-97317-2”。 


如 果 读 者 认为 对 示例 代码 的 使 用 不 在 合理 使 用 和 上 述 无 须 授 权 的 范围 之 内 ， 那 么 请 通过 
permissions @oreilly.com 联系 我 们 。 


O'Reilly Safari 
































Safari (之 前 称 为 Safari Books Online) 是 一 个 为 企业 、 政 府 、 教 育 


SY Safari 机 构 以 及 个 人 提供 培训 的 会 员 制 在 线 学 习 平台 。 


Safari 会 员 可 以 访问 250 多 家 出 版 商 提 供 的 数 千 种 图 书 、 培 训 视 
频 、 学 习 路 径 、 互 动 教程 以 及 精 选 列表 等 资源 ， 这 些 出 版 商 包 括 O'Reilly Media、Harvard 
Business Review、Prentice Hall Professional、Addison-Wesley Professional、 Microsoft 
Press、 Sams、Que、Peachpit Press、Adobe、Focal Press、Cisco Press、John Wiley & Sons、 
Syngress、 Morgan Kaufmann、IBM Redbooks、Packt、Adobe Press、FT Press、Apress、 
Manning、New Riders、 McGraw-Hill、Jones & Bartlett、Course Technology 等 。 





联系 我 们 
如 果 读 者 对 本 书 有 任何 评论 或 疑问 ， 请 通过 以 下 地 址 联系 我 们 。 


美国 : 


O’Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 


奥 莱 利 技术 咨询 (北京 ) 有 限 公 司 
北京 市 西城 区 西直门 南大 街 2 号 成 铭 大 厦 C 座 807 室 (100035) 


有 关 本 书 的 技术 性 问题 和 建议 ， 请 通过 邮箱 bookquestions@oreilly.com 联系 我 们 。 
欢迎 访问 O'Reilly Media 网 站 ， 获 取 更 多 的 图 书 、 课 程 、 会 议 信息 以 及 最 新 动态 。 
我 们 的 Facebook 地 址 是 http://facebook.com/oreilly。 








请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia。 
我 们 的 YouTube 视频 地 址 是 http://www.youtube.com/oreillymedia。 
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注 2: NFJS 巡回 研讨 会 (No Fluff Just Stuff Software Symposium Tour) 于 2001 年 在 美国 丹佛 创办 ， 重 点 关 

注 现代 软件 开发 与 架构 领域 出 现 的 最 新 技术 和 最 佳 实践 ， 演 讲 者 包括 作者 、 咨 询 师 、 开发 人 员 以 及 行 

业 专 家 。 从 2001 年 至 今 ，NFJS 巡回 研讨 会 已 经 在 全 美 各 地 举办 了 500 多 场 活 动 ， 参 与 人 数 超过 8 万 
人 ,一 一 译 者 注 

注 3: Subramaniam 博士 是 Agile Developer 公司 创始 人 ， 休 斯 敦 大 学 兼职 教授 。 作 为 敏捷 开发 领域 的 权威 人 
士 ,他 培训 了 世界 各 地 数 以 千 计 的 软件 开发 人 员 。 他 还 是 一 位 多 产 的 技术 图 书 作者 ,所 撰写 的 《Groovy 
程序 设计 》 一 书 是 Java 程序 员 学 习 Groovy 的 不 二 之 选 。 另 著 有 《高 效 程序 员 的 45 个 习惯 》《JavaScript 
测试 驱动 开发 》 等 书 。 一 一 译 者 注 

注 4: Gradle Recipes for Android， 由 O’Reilly Media 出 版 ， 该 书 讨论 了 Gradle 构建 工具 在 Android 项 目 中 的 

应 用 。 














































































































著名 科幻 小 说 作家 尼 尔 . 盖 曼 (Neil Gaiman) 曾 表示 ， 在 完成 《美国 众 神 》 一 书 的 写作 后 ， 
他 认为 自己 已 然 了 解 如 何 写 小 说 。 不 过 他 的 朋友 纠正 说 ， 他 只 是 了 解 如 何 写 这 部 小 说 而 
已 。 我 现在 理解 了 这 和 句 话 的 含义 。 本 书 最 初 计 划 写 150 页 左右 ， 包 含 25 到 30 个 范例 ， 而 
成 书 接近 300 页 ， 包 含 了 70 多 个 范例 。 不 过 这 也 使 得 本 书 的 内 容 更 为 详尽 和 深入 ， 比 我 
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玻 漏 ， 责 任 在 他 。( 玩 笑 而 已 ， 责 任 当 然 应 由 我 来 承担 ， 但 请 读者 不 要 告诉 Subramaniam 
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我 在 写作 本 书 的 过 程 中 时 常 得 到 Tim Yates 的 帮助 ， 我 对 此 表示 由 衷 的 感谢 。Tim 是 我 遇 
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于 Groovy， 他 是 个 多 面 手 ， 这 从 他 在 Stack Overflow 的 评价 可 见 一 斑 。 我 在 NFJS 巡回 研 
讨 会 上 发 表 Java 8 的 演讲 时 与 Rod Hilton 相识 ， 他 也 为 书稿 提出 了 不 少 反 馈 意见 。Tim 和 
Rob 的 建议 都 弥 足 珍贵 。 


我 有 幸 与 优秀 的 O'Reilly Media 团队 合作 ， 出 版 了 两 本 图 书 、 十 几 部 视频 教程 以 及 大 量 在 
线 培训 课程 ， 读 者 可 以 通过 在 线 平 台 O’Reilly Safari 获取 这 些 资 源 。Brian Foster 不 仅 提 
供 了 始终 如 一 的 支持 ， 也 展现 了 他 克服 官僚 作风 的 出 众 能 力 。 我 在 撰写 上 一 本 图 书 时 与 
Brian 相识 ， 尽 管 他 并 未 担任 本 书 的 编辑 ， 但 他 的 帮助 使 我 受益 民 多 ， 我 们 始终 保持 着 良 
好 的 关系 。 

对 于 本 书 篇 幅 翻番， 责任 编辑 Jeff Bleiel 给 予 了 充分 理解 ， 并 对 如 何 组 织 书稿 提供 了 不 少 
建议 。 我 非常 高 兴 与 Jeff 共事 ， 也 希望 我 们 今后 能 继续 合作 。 

我 对 以 下 NFJS 演讲 嘉宾 表示 感谢 ， 他 们 不 断 的 鼓励 是 我 前 行 的 动力 : Nate Schutta、 
Michael Carducci、Matt Stine、Brian Sletten、Mark Richards、Pratik Patel、Neal Ford、Craig 
Walls、Raju Gandhi、Kirk Knoernschild、Dan “the Man”Hinojosa 以 及 Janelle Klein。 无 论 
写 书 还 是 教学 培训 (我 的 实际 工作 )， 都 是 孤独 的 事业 。 我 在 社区 结识 了 很 多 朋友 和 同事 ， 
大 家 共同 讨论 ， 一 起 玩 要 。 于 我 而 言 ， 这 是 一 种 有 益 的 体验 。 

最 后 ， 我 要 对 妻子 Ginger 和 儿子 Xander 表示 诚挚 的 谢意 。 没 有 你 们 的 支持 和 体谅 ， 就 没 
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我 的 重要 意义 。 


电子 书 


扫描 如 下 二 维 码 ， 即 可 购买 本 书 电子 版 。 
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基础 知识 





Java 8 的 最 大 变化 是 引入 了 国 数 式 编程 (functional programming) 的 概念 。 具 体 而 言 ，Java 8 
增加 了 lambda 表达 式 (lambda expression) 、 方 法 引用 (method reference) 和 流 (stream)。 


如 有 果 读 者 尚未 接触 过 这 些 新 增 的 函数 式 特 性 ， 或 许 会 惊讶 于 写 出 的 代码 和 之 前 大 相 径 庭 。 
Java 8 的 变化 堪 称 迄今 为 止 这 门 语言 最 大 的 变化 。 从 许多 方面 来 说 ， 这 与 学 习 一 门 全 新 的 
语言 并 无 二 致 。 

读者 或 许 会 问 ， 这 样 做 的 目的 是 什么 ? 为 什么 要 对 一 门 已 有 20 年 历史 且 计划 保持 向 后 兼 
容 性 的 语言 做 出 如 此 巨大 的 改变 ? 一 门 为 各 方 所 公认 的 成 熟 语言 ， 是 否 需要 这 些 重大 的 修 
改 ? 作 为 这 些 年 来 最 成 功 的 面向 对 象 语言 之 一 ，Java 为 何 要 转向 国 数 式 范式 ? 


答案 在 于 ， 软 件 开发 领域 已 经 发 生变 化 ， 希 望 今后 依然 立 于 不 败 之 地 的 语言 同样 需要 适应 
这 种 变化 。20 世纪 90 年 代 中 期 , 在 Java 刚 问 世 时 ,摩尔 定律 “仍然 被 奉 为 金 科 玉 律 。 人 们 
只 需 等 上 几 年 ， 计 算 机 的 运行 速度 就 会 提高 一 倍 。 

如 今 ， 硬 件 不 再 依赖 于 通过 增加 心 片 密度 来 提高 速度 。 相 反 ， 连 手机 都 已 大 部 分 配备 了 多 
核 处 理 器 ， 这 意味 着 编写 的 软件 需要 具备 在 多 处 理 器 环境 下 运行 的 能 力 。 函 数 式 编程 强调 
“ 纯 ” 函 数 (基于 相同 的 输入 将 返回 相同 的 结果 ， 无 副作用 存在 ) 以 及 不 可 变性 ， 从 而 简 
化 了 并 行 环境 下 的 编程 。 如 果 不 引 入 任何 共享 、 可 变 的 状态 ， 且 程序 可 以 被 分 解 为 若干 简 
单 函 数 的 集合 ， 就 更 容易 理解 并 预测 程序 的 行为 。 

不 过 ， 本 书 并 非 一 本 介绍 Haskell、Erlang、Frege 或 任何 其 他 函数 式 编程 语言 的 教程 ， 而 
是 侧重 于 探讨 Java 以 及 它 所 引入 的 函数 式 概念 。 从 本 质 上 讲 ，Java 仍然 是 一 门面 向 对 象 的 


语言 。 




























































































注 1: 由 仙 童 半导体 公司 (Fairchild Semiconductor) 和 英特尔 联合 创始 人 戈 登 。 摩尔 (Gordon Moore) 提出 。 根 
据 观 察 , 大 约 每 18 个 月 ,封装 到 集成 电路 中 的 晶体 管 数量 将 增加 一 倍 。 参 见 维基 百科 的 “摩尔 定律 ” 词 条 。 
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Java 目前 支持 lambda 表达 式 ， 它 本 质 上 是 被 视 为 一 类 对 象 (first-class object) 的 方法 。 
Java 还 增加 了 方法 引用 ， 允 许 在 任何 需要 lambda 表达 式 的 场合 使 用 现 有 的 方法 。 为 利用 
lambda 表达 式 和 方法 引用 ，Java 引入 了 流 模型 。 流 模型 生成 元 素 并 通过 流水 线 (pipeline) 
进行 传递 和 过 滤 ， 无 须 修改 原始 源 代码 。 


本 章 的 范例 将 介绍 lambda 表达 式 、 方 法 引用 与 函数 式 接口 (functional interface) 的 基本 语 
法 ， 并 讨论 接口 中 的 默认 方法 和 静态 方法 。 有 关 流 的 详细 讨论 ， 参 见 第 3 章 。 


1.1 _ lambda 表达 式 


问题 

用 户 和 希望 在 代码 中 使 用 lambda 表达 式 。 

方案 

使 用 某 种 lambda 表达 式 语 法 ， 并 将 结果 赋 给 函数 式 接口 类 型 的 引用 。 


讨论 

函数 式 接口 是 一 种 包含 单一 抽象 方法 (single abstract method) 的 接口 。 类 通过 为 接口 中 的 
所 有 方法 提供 实现 来 实现 任何 接口 ， 这 可 以 通过 顶级 类 (top-level class) 、 内 部 类 甚至 匿名 
内 部 类 完成 。 

以 Runnable 接口 为 例 ， 它 从 Java 1.0 开始 就 已 存在 。 该 接口 包含 的 单一 抽象 方法 是 run， 
它 不 传人 任何 参数 并 返回 votd。Thread 类 构造 函数 传人 Runnabte 作为 参数 ， 例 1-1 显示 了 
Runnable 接口 的 匿名 内 部 类 实现 。 


例 1-1 Runnable 接口 的 匿名 内 部 类 实现 
public class RunnableDemo { 
public static void main(String[] args) { 
new Thread(new Runnable() { ©O 
@Override 
public void run() { 
System.out.printLn( 
"inside runnable Using an anonymous inner class"); 















































} 
}).start(); 
} 
@ 匿名 内 部 类 
匿名 内 部 类 语法 以 关键 字 new 开头 ， 后 面 跟着 Runnable 接口 名 以 及 英文 小 括号 ， 表示 定 义 


一 个 实现 该 接口 但 没有 显 式 名 (explicit name) 的 类 。 大 括号 〈{}) 中 的 代码 重 写 run 方 
法 ， 将 字符 串 打印 到 控制 台 。 


例 1-2 中 的 代码 采用 lambda 表达 式 ， 对 例 1-1 进行 了 改写 。 
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例 1-2 在 Thread 构造 国 数 中 使 用 lambda 表达 式 
new Thread(() -> System.out.printtLn( 
"inside Thread constructor using Lambda" )) .start(); 


上 述 代 码 使 用 箭头 将 参数 与 函数 体 隔 开 (由 于 没有 参数 ， 这 里 只 使 用 一 对 空 括号 )。 可 以 
看 到 ， 函 数 体 只 包含 一 行 代码 ， 所 以 不 需要 大 括号 。 这 种 语法 被 称 为 lambda 表达 式 。 广 
意 ， 任 何 表 达 式 求 值 都 会 自动 返回 。 在 本 例 中 ， 由 于 println 方法 返回 的 是 void， 所 以 该 
表达 式 同样 会 返回 void， 与 run 方法 的 返回 类 型 相 匹 配 。 

lambda 表达 式 必 须 匹 配 接口 中 单一 抽象 方法 签名 的 参数 类 型 和 返回 类 型 ， 这 被 称 为 与 方法 
签名 兼容 。 因 此 ，lambda 表达 式 属 于 接口 方法 的 实现 ， 可 以 将 其 赋 给 该 接口 类 型 的 引用 。 


例 1-3 显示 了 赋 给 某 个 变量 的 lambda 表达 式 。 


例 1-3 将 lambda 表达 式 赋 给 变量 
Runnable r = () -> System.out.printLn( 
"Lambda expression implementing the run method"); 
new Thread(r).start(); 














Java 库 中 不 存在 名 为 Lambda 的 类 ，lambda 表达 式 只 能 被 赋 给 函数 式 接口 引用 。 














“将 lambda 表达 式 赋 给 函数 式 接口 ”与 “lambda 表达 式 属 于 函数 式 接 口中 单一 抽象 方法 

的 实现 ”表示 相同 的 含义 。 我 们 可 以 将 lambda 表达 式 视 为 实现 接口 的 匿名 内 部 类 的 主体 。 

这 就 是 lambda 表达 式 必 须 与 抽象 方法 兼容 的 原因 ， 甚 参数 类 型 和 返回 类 型 必须 匹配 该 方 

法 的 签名 。 注 意 ， 所 实现 方法 的 名 称 并 不 重要 ， 它 不 会 作为 lambda 表达 式 语法 的 一 部 分 

出 现在 代码 中 。 

因为 run 方 法 不 传 入 参数 ， 并 且 返 回 void， 所 以 本 例 特 别 简单 。 函 数 式 接口 java. 

io.FilenameFilter 从 Java 1.0 开始 就 是 Java 标准 库 的 一 部 分 ， 该 接口 的 实例 被 用 作 File. 

List 方法 的 参数 ， 只 有 满足 该 方法 的 文件 才 会 被 返回 。 

根据 Javadoc 的 描述 ，FilenameFilter 接口 包含 单一 抽象 方法 accept， 它 的 签名 如 下 : 
boolean accept(File dir, String name) 

其 中 ，File 参数 用 于 指定 文件 所 在 的 目录 ，String 用 于 指定 文件 名 。 

例 1-4 采用 匿名 内 部 类 来 实现 FilenameFilter 接口 ， 只 返回 Java 源 文件 。 

例 1-4 FilenameFilter 的 匿名 内 部 类 实现 


File directory = new File("./src/main/java"); 























String[] names = directory.list(new FilenameFilter() { ©@ 
@Override 
public boolean accept(File dir, String name) { 
return name.endsWith(".java"); 


}); 


System.out.println(Arrays.asList(names)); 
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@ 匿名 内 部 类 

在 例 1-4 中 ， 如 果 文 件 名 以 .java 结尾 ，accept 方法 将 返回 true， 否 则 返回 false。 
而 例 1-5 采用 lambda 表达 式 实 现 FilenameFilter 接口 。 

例 1-5 FilenameFilter 接口 的 lambda 表达 式 实现 


File directory = new File("./src/main/java"); 


























String[] names = directory.list((dir, name) -> name.endsWith(".java")); © 
System.out.println(Arrays.asList(names)); 


} 
@ lambda 表达 式 
可 以 看 到 ， 代 码 要 简单 得 多 。 参 数 包含 在 小 括号 中 ,但 并 未 声明 类 型 。 在 编译 时 ， 编 译 器 
发 现 List 方法 传人 一 个 FilenameFilter 类 型 的 参数 ， 从 而 获知 其 单一 抽象 方法 accept 的 签 
名 ， 进 而 了 解 accept 的 参数 为 File 和 String， 因 此 兼容 的 lambda 表达 式 参 数 必须 匹配 这 些 
类 型 。 由 于 accept 方法 的 返回 类 型 是 布尔 值 ， 所 以 箭头 右 侧 的 表达 式 也 必须 返回 布尔 值 。 
如 例 1-6 所 示 ， 我 们 也 可 以 在 代码 中 指定 数据 类 型 。 


例 1-6 具有 显 式 数据 类 型 的 lambda 表达 式 


File directory = new File("./src/main/java"); 






































String[] names = directory.list((File dir, String name) -> © 
name.endsWith(".java")); 


@ 显 式 数据 类 型 


此 外 ， 如 果 lambda 表达 式 的 实现 多 于 一 行 ， 则 需要 使 用 大 括号 和 显 式 返回 语句 ， 如 例 1-7 
所 示 。 


例 1-7 lambda 代码 块 


File directory = new File("./src/main/java"); 











String[] names = directory.list((File dir, String name) -> { © 
return name.endsWith(".java"); 


]); 

System.out.printLn(Arrays.asList(names) ); 
@ 代码 块 语法 
这 就 是 lambda 代码 块 (block lambda) 。 在 本 例 中 ， 虽 然 代 码 主体 只 有 一 行 ， 但 可 以 使 用 大 
括号 将 多 个 语句 括 起 来 。 注 意 ， 不 能 省 略 return 关键 字 。 
lambda 表达 式 在 任何 情况 下 都 不 能 脱离 上 下 文 存 在 ， 上 下 文 指 定 了 将 表达 式 赋 给 哪个 国 数 
式 接口 。lambda 表达 式 既 可 以 是 方法 的 参数 ， 也 可 以 是 方法 的 返回 类 型 ， 还 可 以 被 赋 给 引 
用 。 无 论 哪 种 情况 ， 赋 值 类 型 必须 为 国 数 式 接口 。 














1.2 万 法 引用 


问题 

用 户 希望 使 用 方法 引用 来 访问 某 个 现 有 的 方法 ， 并 将 其 作为 lambda 表达 式 进行 处 理 。 
方案 

使 用 双 冒 号 表示 法 (::) 将 实例 引用 或 类 名 与 方法 分 开 。 

讨论 

如 果 说 lambda 表达 式 本 质 上 是 将 方法 作为 对 象 进行 处 理 ， 那 么 方法 引用 就 是 将 现 有 方法 
作为 lambda 表达 式 进行 处 理 。 


例如 ，java.lang.Iterable 接口 的 forEach 方法 传 入 Consumer 作为 参数 。 如 例 1-8 所 示 ， 
Consumer 可 以 作为 l ambda 表达 式 或 方法 引用 来 实现 。 
例 1-8 利用 方法 引用 访问 println 方法 


Stream.of(3, 1, 4, 1, 5, 9) 
.forEach(x -> System.out.println(x)); 0 








Stream.of(3, 1, 4, 1, 5, 9) 
.forEach(System.out::println); (2) 


Consumer<Integer> printer = System.out::println; ©@ 
Stream.of(3, 1, 4, 1, 5, 9) 
.forEach(printer); 

@ 使 用 lambda 表达 式 
@ 使 用 方法 引用 
@ 将 方法 引用 赋 给 函数 式 接 口 
双 冒 号 表示 法 在 System.out 实例 上 提供 了 对 printtn 方法 的 引用 ， 它 属于 PrintStreanm 类 
型 的 引用 。 方 法 引用 的 末尾 无 须 括号 。 在 本 例 中 ， 程 序 将 流 的 所 有 元 素 打 印 到 标准 输出 。” 


























如 果 编 写 一 个 只 有 一 行 的 lambda 表达 式 来 调用 方法 ， 不 妨 孝 虑 改 用 等 价 的 
方法 引用 。 








与 lambda 语法 相 比 ， 方 法 引用 具有 几 个 (不 那么 显著 的 ) 优点 。 首 先 ， 方法 引用 往往 更 
短 。 其 次 ， 方 法 引用 通常 包括 含有 该 方法 的 类 的 名 称 。 这 两 点 使 得 代码 更 易于 阅读 。 








注 2: 讨论 lambda 表达 式 或 方法 引用 时 ， 很 难 不 涉及 流 ， 第 3 章 将 专门 讨论 流 。 目 前 可 以 这 样 理解 ， 流 依 
次 产生 一 系列 元 素 ， 但 不 会 将 它们 存储 在 任何 位 置 ， 也 不 会 对 原始 源 进 行 修改 。 
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如 例 1-9 所 示 ， 方 法 引用 也 可 以 和 静态 方法 一 起 使 用 。 
例 1-9 在 静态 方法 中 使 用 方法 引用 





Stream.generate(Math: :random) 0 
.limit(10) 
.forEach(System.out::println); @ 

@ 静态 方法 
@ 实例 方法 


Streanm 接口 定义 的 generate 方法 传人 Supplier 作为 参数 。Supplier 是 一 个 国 数 式 接 口 ， 
其 单一 抽象 方法 get 不 传人 任何 参数 且 只 生成 一 个 结果 。Math 类 的 randon 方法 与 get 方法 
的 签名 相互 兼容 ， 因 为 randon 方法 同样 不 传 入 任何 参数 ， 且 产生 一 个 0 到 1 之 间 、 均 匀 分 
布 的 双 精 度 伪 随机 数 。 方 法 引用 Math: :randon 表示 该 方法 是 Supplier 接口 的 实现 。 

由 于 Stream.generate 方法 产生 的 是 一 个 无 限 流 (infinite stream)， 我 们 通过 Limit 方法 限 
定 只 生成 10 个 值 ， 然 后 使 用 方法 引用 System.out::println 将 这 些 值 打 印 到 标准 输出 ， 作 
为 Consumer 的 实现 。 

语法 

方法 引用 包括 以 下 三 种 形式 ， 其 中 一 种 存在 一 定 的 误导 性 。 

object: :instanceMethod 


引用 特定 对 象 的 实例 方法 ， 如 System.out: :println。 
Class::staticMethod 

引用 静态 方法 ， 如 Math: :max。 
Class::instanceMethod 

调用 特定 类 型 的 任意 对 象 的 实例 方法 ， 如 String: :length。 


最 后 一 种 形式 或 许 令 人 困惑 ， 因 为 在 Java 开发 中 ， 一 般 只 通过 类 名 来 调用 静态 方法 。 请 记 
住 ，lambda 表达 式 和 方法 引用 在 任何 情况 下 都 不 能 脱离 上 下 文 存在 。 以 对 象 引用 为 例 ， 上 
下 文 提 供 了 方法 的 参数 。 对 于 System.out::printtn， 等 效 的 lambda 表达 式 为 《如 例 1-8 
中 的 上 下 文 所 示 ) : 


// 相当 于 System.out: :printtn 
x -> System.out.printLn(x) 


上 下 文 提供 了 x 的 值 ， 它 被 用 作 方 法 的 参数 。 
静态 方法 max 与 之 类 似 : 


// 相当 于 Math: :max 
(x,y) -> Math.max(x,y) 


此 时 ， 上 下 文 需要 提供 两 个 参数 ，lambda 表达 式 返 回 较 大 的 参数 。 
“通过 类 名 来 调用 实例 方法 ”语法 的 解释 有 所 不 同 ， 甚 等 效 的 lambda 表达 式 为 : 


// 相当 于 String: :Length 
x -> x.length() 
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此 时 ， 当 上 下 文 提供 x 的 值 时 ， 它 将 用 作 方 法 的 目标 而 非 参数 。 

















如 果 通 过 类 名 引用 一 个 传人 多 个 参数 的 方法 ， 则 上 下 文 提供 的 第 一 个 元 素 将 
作为 方法 的 目标 ， 其 他 元 素 作为 方法 的 参数 。 





例 1-10 显示 了 相应 的 代码 。 
例 1-10 从 类 引用 (class reference) 调用 多 参数 实例 方法 


List<String> strings = 
Arrays.asList("this", "is", "a", "list", "of", "strings"); 
List<String> sorted = strings.stream() 
.sorted((s1i, s2) -> si.compareTo(s2)) ©@ 
.collect(Collectors.toList()); 


List<String> sorted = strings.stream() 
.Sorted(String::compareTo) 0 
.collect(Collectors.toList()); 


@ 方法 引用 及 其 等 效 的 lambda 表达 式 


Stream 接口 定义 的 sorted 方 法 传 入 Comparator<T> 作为 参数 ， 其 单一 抽象 方法 为 int 
compare(String other)。sorted 方法 将 每 对 字符 串 提 供给 比较 器 ， 并 根据 返回 整数 的 符号 
对 它们 进行 排序 。 在 本 例 中 ， 上 下 文 是 一 对 字符 串 。 方 法 引用 语法 (采用 类 名 string) 调 
用 第 一 个 元 素 (lambda 表达 式 中 的 s1) 的 compareTo 方法 ， 并 使 用 第 二 个 元 素 s2 作为 该 
方法 的 参数 。 
在 流 处 理 中 ， 如 果 需 要 处 理 一 系列 输入 ， 则 会 频繁 使 用 方法 引用 中 的 类 名 来 访问 实例 方 
法 。 例 1-11 显示 了 对 流 中 各 个 String 调用 Length 方法 。 
例 1-11 使 用 方法 引用 在 String 上 调用 length 方法 
Stream.of("this", "is", "a", "stream", "of", "strings") 
.map(String::length) 0 
.forEach(System.out::println); @ 
@ 通过 类 名 访问 实例 方法 
@ 通过 对 象 引 用 访问 实例 方法 
程序 调用 Length 方法 将 每 个 字符 串 转 换 为 一 个 整数 ， 然 后 打印 所 有 结果 。 
方法 引用 本 质 上 属于 lambda 表达 式 的 一 种 简化 语法 。lambda 表达 式 在 实际 中 更 常见 ， 因 
为 每 个 方法 引用 都 存在 一 个 等 效 的 lambda 表达 式 ， 反 之 则 不 然 。 对 于 例 1-11 中 的 方法 引 
用 ， 其 等 效 的 lambda 表达 式 如 例 1-12 所 示 。 
例 1-12 方法 引用 的 等 效 lambda 表达 式 
Stream.of("this", "is", "a", "stream", "of", "strings") 


.map(s -> s.Length()) 
.forEach(x -> System.out.printLn(x) ); 
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对 任何 lambda 表达 式 来 说 ， 上 下 文 都 很 重要 。 为 避免 臣 义 ， 不 妨 在 方法 引用 的 左 侧 使 用 
this 或 super 。 





另 见 
用 户 也 可 以 使 用 方法 引用 语法 来 调用 构造 国 数 ， 相 关 讨论 参见 范例 13。 第 2 章 将 讨论 
java.util.function 包 以 及 本 范例 中 出 现 的 Supplier 接口 。 


告 也 深 
1.3 构造 函数 引用 
问题 
用 户 希 望 将 方法 引用 作为 流 的 流水 线 (stream pipeline) 的 一 部 分 ， 以 实例 化 某 个 对 象 。 
方案 
在 方法 引用 中 使 用 new 关键 字 。 








讨论 
在 讨论 Java 8 引入 的 新 语法 时 ， 通 常会 提 及 lambda 表达 式 、 方 法 引用 以 及 流 。 例 如 ， 我 
们 和 希望 将 一 份 人 员 列 表 转 换 为 相应 的 姓名 列表 。 例 1-13 的 代码 段 显示 了 解决 这 个 问题 的 两 
种 方案 。 


例 1-13 将 人 员 列 表 转 换 为 姓名 列表 
List<String> names = people.stream() 
.map(person -> person.getName()) © 
.COLLect(CoLLectors .toList()); 


// 或 者 采用 以 下 方案 
List<String> names = people.stream() 


.map(Person: :getName) @ 
.COLLect(CoLLectors .toList()); 





@ lambda 表达 式 

@ 方法 引用 

那么 ， 是 否 存在 其 他 解决 方案 呢 ? 如 何 根据 字符 串 列 表 来 创建 相应 的 Pearson 引用 列表 呢 ? 
尽管 仍然 可 以 使 用 方法 引用 ， 不 过 这 次 我 们 改 用 关键 字 new， 这 种 语法 称 为 构造 函数 引用 
(constructor reference ) 。 

为 了 说 明 构 造 函 数 引 用 的 用 法 ， 我 们 首先 创建 一 个 Person 类 ， 它 是 最 简单 的 Java 对 象 
(POJO)。Person 类 的 唯一 作用 是 包装 一 个 名 为 nane 的 简单 字符 串 特 性 ， 如 例 1-14 所 示 。 














例 1-14 Person 类 


public class Person { 
private String name; 


public Person() {} 

public Person(String name) { 
this.name = name; 

// getter 和 setter 


// equals、hashCode 与 tostring 方 法 


} 
0 15 所 示 ， 给 定 一 个 字符 串 集 合 ， 通 过 lambda 表达 式 或 构造 函数 引用 ， 可 以 将 其 中 
的 每 个 字符 串 映射 到 Person 类 。 


例 1-15 将 字符 串 转 换 为 Person 实例 
List<String> names = 
Arrays.asList("Grace Hopper", "Barbara Liskov", "Ada Lovelace", 
"Karen Sparck Jones"); 


List<Person> people = names.stream() 


.map(name -> new Person(name)) © 
.Collect(Collectors. toList()); 


// 或 采用 以 下 方案 





List<Person> people = names.stream() 
.map(Person: :new) © 
.Collect(Collectors. toList()); 


@ 使 用 lambda 表达 式 来 调用 构造 函数 
@ 使 用 构造 函数 引用 来 实例 化 Person 


Person: :new 的 作用 是 引用 Person es 与 所 有 lambda 表达 式 类 似 ， 由 上 下 文 决 
定 执行 哪个 构造 图 数 。 由 于 上 下 文 提 供 了 一 个 字符 串 ， 使 用 单 参数 的 String 构造 国 数 。 

1. 复制 构造 函数 

复制 构造 国 数 (copy constructor) 传人 一 个 Person 参数 ， 并 返回 一 个 具有 相同 特性 的 新 
Person， 如 例 1-16 所 示 。 

例 1-16 Person 的 复制 构造 函数 


public Person(Person p) { 
this.name = p.name; 

















} 


如 果 需 要 将 流 代码 从 原始 实例 中 分 离 出 来 ， 复 制 构造 函数 将 很 有 用 。 假 设 我 们 有 一 个 人 员 
列表 ， 先 将 其 转换 为 流 ， 再 转换 回 列表 ， 那 么 引用 不 会 发 生变 化 ， 如 例 1-17 所 示 。 
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例 1-17 将 列表 转换 为 流 ， 再 转换 回 列表 


Person before = new Person("Grace Hopper"); 


List<Person> people = Stream.of(before) 
.collect(Collectors. toList()); 
Person after = people.get(0); 


assertTrue(before == after); 0 

before.setName("Grace Murray Hopper"); @ 

assertEquals("Grace Murray Hopper", after.getName()); © 
@ 对 象 相 同 


@ 使 用 before 引用 修改 人 名 

@ after 引用 中 的 人 名 已 被 修改 

如 例 1-18 所 示 ， 可 以 通过 复制 构造 函数 来 切断 连接 。 
例 1-18 使 用 复制 构造 函数 


people = Stream.of(before) 
.map(Person: :new) 0 
.Collect(Collectors. toList()); 


after = people.get(0); 
assertFalse(before == after); @ 


assertEquals(before, after); © 


before.setName("Rear Admiral Dr. Grace Murray Hopper"); 
assertFalse(before.equals(after)); 


@ 使 用 复制 构造 函数 
@ 对 象 不 同 
@ 但 二 者 是 等 效 的 


可 以 看 到 ， 当 调用 map 方法 时 ， 上 下 文 是 Person 实例 的 流 。 因 此 ，Person: :new 调用 构造 
国 数 ， 它 传 入 一 个 Person 实例 并 返回 一 个 等 效 的 新 实例 ， 同 时 切断 了 before 和 after 引 











用 之 间 的 连接 。” 
2. 可 变 参 数 构造 函数 





接 下 来 ， 我 们 为 Person POJO 添加 一 个 可 变 参数 构造 函数 (varargs constructor) ， 如 例 1-19 


所 示 。 





注 3: 需要 说 明 的 是 ,将 葛 丽 丝 * 霍 普 (Grace Hopper) 将 军 作 为 本 书 代码 中 的 “对 象 ” 绝 无 冒犯 之 意 。 作者 深信 ， 





















































debug 也 是 由 霍 普 团队 首先 使 用 并 流传 开 来 的 。 译 者 注 ) 














尽管 霍 普 将 军 已 于 1992 年 去 世 , 她 的 水 平 仍然 是 作者 所 无 法 企及 的 。 
也 是 爹 球 最 早 的 程序 员 之 一 。 霍 普 开 发 了 COBOL 语言 ， 被 誉 为 “COBOL 之 母 "， 计 算 机 











( 饮 丽 丝 " 霍 普 是 美 


车 














海军 ? 











佳 将 ， 
L 术 语 bug 和 
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例 1-19 构造 函数 Person 传人 String 的 可 变 参数 列表 


public Person(String... names) { 
this.name = Arrays.stream(names) 
.Collect(Collectors.joining(" ")); 


} 
上 述 构造 国 数 传人 零 个 或 多 个 字符 串 参 数 ， 并 使 用 空格 作为 定 界 符 将 这 些 参数 拼接 在 一 起 。 


那么 ， 如 何 调用 这 个 构造 国 数 呢 ? 任何 传人 零 个 或 多 个 字符 串 参 数 (由 逗号 隔 开 ) 的 客户 
端 都 会 调用 这 个 构造 函数 。 一 种 方案 是 利用 String 类 定义 的 split 方法 ， 它 传人 一 个 定 界 
符 并 返回 一 个 String 数组 。 


String[] split(String delimiter) 
因此 ， 例 1-20 中 的 代码 将 列表 中 的 每 个 字符 串 拆 分 为 单个 单词 ， 并 调用 可 变 参数 构造 
例 1-20 可 变 参 数 构造 函数 的 应 用 


names.stream() 
.map(name -> name.split(" ")) 
.map(Person: :new) 
.Collect(Collectors. toList()); 


@ 创建 字符 串 流 

@ 映射 到 字符 串 数组 流 

@ 映射 到 Person 流 

@ 收集 到 Person 列表 

在 本 例 中 ，map 方法 的 上 下 文 包含 Person: :new 构造 函数 引用 ， 它 是 一 个 字符 串 数组 流 ， 因 
此 将 调用 可 变 参 数 构造 函数 。 如 果 为 该 构造 函数 添加 一 个 简单 的 打印 语句 : 


System.out.println("Varargs ctor, names=" + Arrays.asList(names)); 


则 输出 如 下 结果 : 


Varargs ctor, names=[Grace, Hopper] 
Varargs ctor, names=[Barbara, Liskov] 
Varargs ctor, names=[Ada, Lovelace] 
Varargs ctor, names=[Karen, Spirck, Jones] 


3. 数组 
构造 函数 引用 也 可 以 和 数组 一 起 使 用 。 如 果 和 希望 采用 Person 实例 的 数组 (Person[]) 而 非 
列表 ， 可 以 使 用 Strean 接口 定义 的 toArray 方法 ， 它 的 签名 为 : 

<A> A[] toArray(IntFunction<A[]> generator) 
toArray 方法 采用 A 表示 返回 数组 的 泛 型 类 型 (generic type)。 数 组 包含 流 的 元 素 ， 由 所 提 
供 的 generator 函数 创建 。 我 们 甚至 还 能 使 用 构造 函数 引用 ， 如 例 1-21 所 示 。 
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例 1-21 创建 Person 引用 的 数组 
Person[] people = names.stream() 
.map(Person: :new) 0 
.toArray(Person[]::new); @ 


@ Person 的 构造 函数 引用 
@ Person 数组 的 构造 函数 引用 

toArray 方法 参数 创建 了 一 个 大 小 合适 的 Person 引用 数组 ， 并 采用 经 过 实例 化 的 Person 实 
例 进行 填充 。 

构造 函数 引用 其 实 是 方法 引用 的 别称 ， 通 过 关键 字 new 调用 构造 函数 。 同 样 ， 由 上 下 文 决 
定 调用 哪个 构造 函数 。 在 处 理 流 时 ， 构 造 函 数 引 用 可 以 提供 很 大 的 灵活 性 。 












































另 见 
有 关 方 法 引用 的 讨论 ， 参 见 范例 1.2。 


1.4 范 数 式 接口 


问题 

用 户 希 望 使 用 现 有 的 函数 式 接 口 ， 或 编写 自 定义 函数 式 接口 。 

方案 

创建 只 包含 单一 抽象 方法 的 接口 ， 并 为 其 添加 @FunctionalInterface 注解 。 

讨论 

Java 8 引入 的 函数 式 接口 是 一 种 包含 单一 抽象 方法 的 接口 ， 因 此 可 以 作为 lambda 表达 式 或 
方法 引用 的 目标 。 


关键 字 abstract 在 这 里 很 重要 。 在 Java 8 之 前 ， 接 口中 的 所 有 方法 被 默认 视 为 抽象 方法 ， 
不 需要 为 它们 添加 abstract。 
我 们 定义 一 个 名 为 PalindromeChecker ( 回 文 检查 器 ) 的 接口 ， 如 例 1-22 所 示 。 
例 1-22” 回 文 检查 器 接口 
@FunctionalInterface 


public interface PalindromeChecker { 
boolean ispalidrome(String s); 















































由 于 接口 中 的 所 有 方法 均 为 public 方法 “， 可 以 省 略 访问 修饰 符 ， 如 同 省 略 abstract 关键 
字 一 样 。 














注 4: 至 少 在 Java 9 之 前 ， 接 口中 也 允许 使 用 private 方法 。 更 多 详细 信息 ， 参 见 范例 10.2。 
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由 于 PalindromeChecker 仅 包 含 一 个 抽象 方法 ， 它 属于 国 数 式 接口 。Java 8 在 java.Lang 包 
中 提供 了 @FunctionalInterface 注解 ， 可 以 应 用 到 函数 式 接口 ， 如 例 1-22 所 示 。 
@FunctionalInterface 注解 并 非 必 需 ， 但 使 用 它 是 一 种 好 习惯 ， 原 因 有 两 点 。 首 先 ， 
@FunctionalInterface 注解 会 触发 编译 时 校 验 (compile-time check) ， 有 助 于 确保 接口 符合 
要 求 。 如 果 接 口 不 包含 或 包含 多 个 抽象 方法 ， 程 序 将 提示 编译 错误 。 

其 次 ， 添 加 @FunctionalInterface 注解 后 ， 会 在 Javadoc 中 生成 以 下 语句 : 


Functional Interface: 
This is a functional interface and can therefore be used as the assignment 
target for a Lambda expression or method reference . 


国 数 式 接口 中 同样 可 以 使 用 default 和 static 方法 。 由 于 这 两 种 方法 都 有 相应 的 实现 ， 它 
们 与 “ 仅 包 含 一 个 抽象 方法 ”的 要 求 并 不 矛盾 。 示 例 代码 如 例 1-23 所 示 。 


例 1-23 MyInterface 是 一 个 包含 静态 方法 和 默认 方法 的 函数 式 接口 
































@FunctionalInterface 
public interface MyInterface { 
int myMethod(); 0 


// int myOtherMethod(); ©@ 


default String sayHello() { 
return "Hello, World!"; 


; 


static void myStaticMethod() { 
System.out.println("I'm a static method in an interface"); 
} 
} 


@ 单一 抽象 方法 
@ 如 果 这 条 语句 未 被 注释 掉 ，MyInterface 将 不 再 是 函数 式 接口 
可 以 看 到 ， 如 果 myotherMethod 方法 未 被 广 释 掉 ，MyInterface 就 不 再 满足 函数 式 接 口 的 要 
求 ，@FunctionalInterface 注解 将 报错 :“ 存 在 多 个 非 重 写 的 抽象 方法 。 
接口 可 以 继承 其 他 接口 (其 至 不 止 一 个 )。@FunctionalInterface 注解 将 对 当前 接口 进行 校 
验 。 因 此 ， 如 果 一 个 接口 继承 现 有 的 函数 式 接口 后 ， 又 添加 了 其 他 抽象 方法 ， 该 接口 就 不 
再 是 函数 式 接口 ， 如 例 1-24 所 示 。 
例 1-24 继承 函数 式 接口 的 MyChildInterface 不 再 属于 函数 式 接口 

public interface MyChildInterface extends MyInterface { 


int anotherMethod(); © 
} 


@ 其 他 抽象 方法 


MyChildInterface 不 属于 函数 式 接口 ， 因 为 它 包 含 两 个 抽象 方法 : 继承 自 MyInterface 的 
myMethod 和 声明 的 anotherMethod。 即 便 没 有 添加 @FunctionalInterface 注解 ， 代 码 也 可 
以 编译 ， 因 为 MychildInterface 就 是 一 个 标准 接口 ， 但 无 法 作为 lambda 表达 式 的 目标 。 
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此 外 ， 还 有 一 种 不 太 常 见 的 情况 值得 注意 。Comparator 接口 用 于 排序 ， 其 他 范例 将 对 此 进 
行 讨论 。 查 看 Comparator 接口 的 Javadoc 信息 ， 并 点 击 Abstract Methods (抽象 方法 ) 标签 
后 ， 将 显示 以 下 信息 (图 1-1)。 








Method Summary 
AbstractMethods cl 
Modifier and Type Method and Description 
int compare(T 01，T 02) 
Compares its two arguments for order. 
boolean equals (Object obj) 
Indicates whether some other object is "equal to" this comparator. 














1-1: Comparator 接口 包含 的 抽象 方法 


可 以 看 到 ，Comparator 接口 包含 两 种 抽象 方法 ， 且 其 中 一 种 方法 是 在 java.Lang.0bject 类 
中 实际 实现 的 ， 那 么 Comparator 为 什么 还 属于 函数 式 接口 呢 ? 

这 里 的 特别 之 处 在 于 ， 图 中 显示 的 equals 方法 来 自 0bject 类 ， 因 此 已 有 一 个 默认 的 实 
现 。 根 据 Javadoc 的 描述 ， 出 于 性 能 方面 的 考虑 ， 用 户 可 以 提供 满足 相同 契约 (interface 
contract) 的 自 定义 equals 方法 ， 但 不 对 该 方法 进行 重 写 “始终 是 安全 的 ”。 

根据 函数 式 接 口 的 定义 ，0bject 类 中 的 方法 与 单一 抽象 方法 的 要 求 并 不 矛盾 ， 因 此 Comparator 
仍然 属于 函数 式 接口 。 


























品 见 
力作 
接口 中 默认 方法 的 相关 应 用 ， 参 见 范例 1.5。 接 口中 静态 方法 的 相关 应 用 ， 参 见 范例 1.6。 


1.5 接口 中 的 默认 方 ; 

问题 

用 户 希 望 在 接口 中 提供 方法 的 实现 。 

方案 

将 接口 方法 声明 为 default， 并 以 常规 方式 添加 实现 。 

讨论 

Java 之 所 以 不 支持 多 继承 (multiple inheritance) ， 是 为 了 避免 所 谓 的 钻石 问题 (diamond 
problem) 。 考 虑 如 图 1-2 所 示 的 继承 层次 结构 (有 点 类 似 UML ) 。 




















Animal 
speak() 
Horse Bird 

speak() speak() 
Pegasus 
speak() 






















1-2，Animal 继承 


Animal 类 包括 Bird 和 Horse 两 个 子 类 ， 二 者 重 写 了 Animal 的 speak 方法 : Horse 是 “ 晰 
电 ”(whinny)， 而 Bird 是 “嘿嘿 ”(chirp)。 那 么 Pegasus (从 Horse 和 Bird 继承 而 来 ) 5 
呢 ? 如 果 将 Animal 类 型 的 引用 赋 给 Pegasus 的 实例 会 怎样 ? speak 方法 又 该 返回 什么 呢 ? 
Animal animal = new Pegaus(); 
animal.speak(); // 电 晰 、 哪 叫 还 是 其 他 声音 ? 
不 同 语言 处 理 这 个 问题 的 方法 各 不 相同 。 例 如 ，C++ 支持 多 继承 ， 但 如 果 某 个 类 继承 了 相 
互 冲突 的 实现 则 不 会 被 编译 。" 而 在 Eiffel 中 ， 编 译 器 允许 用 户 选 择 所 需 的 实现 。 
Java 禁止 多 继承 。 为 避免 一 个 类 与 多 种 类 型 都 具有 “ 某 种 ”关系 ，Java 引入 接口 作为 解决 
方案 。 由 于 接口 只 包含 抽象 方法 ， 不 会 存在 相互 冲突 的 实现 。 接 口 之 所 以 允许 多 继承 ， 是 
因为 只 有 方法 签名 被 继承 。 
问题 在 于 ， 如 果 永 远 无 法 在 接口 中 实现 方法 ， 就 会 导致 一 些 奇怪 的 情况 出 现 。L[ java. 
util.Collection 接口 为 例 ， 它 定义 了 以 下 方法 : 
boolean isEmpty() 
int size() 
如 果 和 集合 中 没有 元 素 ，isEmpty 方法 将 返回 true， 否 则 返回 false。 而 size 方法 返回 集合 中 
元 素 的 数量 。 如 例 1-25 所 示 ， 无 论 底层 实现 如 何 ， 都 可 以 根据 size 立即 实现 isEmpty 方法 。 


例 1-25 根据 size 实现 isEmpty 方法 
public boolean isEmpty() { 
return size() == 0; 



































注 5;“ 一 匹 长 有 双翼 的 骏马 。 ( 源 自 迪士尼 电影 《大 力士 海 格力 斯 》 你 不 会 没 听 说 过 希腊 神话 和 海 格 力 斯 
吧 ? ) 
注 6: 但 仍然 可 以 使 用 虚 继 承 (virtual inheritance) 来 解决 这 个 问题 。 

注 7: Eiffel 或 许 对 读者 来 说 略 显 隆 誉 ， 它 是 面向 对 象 编程 的 基础 语言 之 一 。 感 兴趣 的 话 ， 可 以 参考 
Bertrand Meyer 撰写 的 Object-Oriented Sofitware Construction, Second Edition， 该 书 由 Prentice Hall 于 
1997 年 出 版 。 
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由 于 CoLLection 是 一 个 接口 ， 不 能 对 它 进行 这 样 的 处 理 ， 但 可 以 使 用 Java 标准 库 提供 
的 java.util.AbstractCollection 类 。 它 是 一 个 抽象 类 ， 所 包含 的 isEmpty 方法 与 本 例 中 
isEmpty 的 实现 完全 相同 。 如 果 用 户 正在 创建 自 定义 的 集合 实现 〈(collection implementation ) 
且 还 没有 超 类 ， 可 以 通过 继承 AbstractCollection 类 来 获得 isEmpty 方法 。 不 过 如 果 已 有 超 
类 ， 就 必须 改 为 实现 Collection 接口 ， 且 不 要 忘记 提供 自 定义 的 isEmpty 和 size 实现 。 

这 些 对 经 验 丰 富 的 Java 开发 人 员 而 言 很 容易 ， 但 从 Java 8 开始 ， 情 况 有 所 改变 。 目 前 只 须 
将 某 个 方法 声明 为 default 并 提供 一 个 实现 ， 就 能 为 接口 方法 添加 实现 。 如 例 1-26 所 示 ， 
Employee 接口 包含 两 种 抽象 方法 和 一 种 默认 方法 。 

例 1-26 Employee 接口 包含 默认 方法 


public interface Employee { 
String getFirst(); 



































String getLast(); 
void convertCaffeineToCodeForMoney(); 


default String getName() { © 
return String.format("%s %s", getFirst(), getLast()); 


} 
@ 具有 实现 的 默认 方法 


getName 方法 由 关键 字 default 声明 ， 其 实现 取决 于 Employee 接口 的 另外 两 种 抽象 方法 ， 
即 getFirst 和 getLast。 

为 保持 向 后 兼容 性 ，Java 的 许多 现 有 接口 都 采用 默认 方法 进行 了 增强 。 一 般 而 言 ， 为 接口 
添加 新 方法 会 破坏 所 有 现 有 的 实现 。 如 果 添 加 的 新 方法 被 声明 为 默认 方法 ， 则 所 有 现 有 的 
实现 将 继承 新 方法 且 仍 然 有 效 。 这 使 得 库 维护 者 可 以 在 JDK 中 添加 新 的 默认 方法 ， 而 不 会 
破坏 现 有 的 实现 。 

例如 ，java.util.Collection 接口 目前 包含 以 下 默认 方法 : 

















default boolean removeIf(Predicate<? super E> filter) 
default Stream<E> stream() 
default Stream<E> paraLLeLStream() 


default Spliterator<E> spliterator() 


removeIf 方法 将 删除 集合 中 所 有 满足 Predicate’ 参数 的 元 素 ， 如 果 删 除了 任何 元 素 ， 该 
方法 将 返回 true。stream 和 parallelstream 方 法 用 于 创建 流 ， 二 者 属于 工厂 方法 。 
spliterator 方法 从 实现 Spliterator 接口 的 类 中 返回 一 个 对 象 ， 它 对 来 自 源 的 元 素 进 行 遍 
历 和 分 区 。 


如 例 1-27 所 示 ， 黑 认 方法 与 其 他 方法 的 用 法 并 无 二 致 。 




















注 8: Predicate 是 java.util.function 包 新 增 的 一 种 函数 式 接口 ， 相 关 讨 论 请 参见 范例 2.3。 
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例 1-27 默认 方法 的 应 用 
List<Integer> nums = new ArrayList<>(); 
nums .add(-3); 
nums.add(1); 
nums .add(4); 
nums.add(-1); 
nums .add(5); 
nums .add(9); 
boolean removed = nums .removeIf(n -> n <= 0); ©@ 
System.out.printLn("ELements were " + (removed ? "" : "NOT") + " removed"); 
nums.forEach(System.out: :println); (2) 


@ 使 用 Collection 接口 定义 的 默认 方法 removeIf 
@ 使 用 Iterator 接口 定义 的 默认 方法 forEach 


如 果 一 个 类 采用 同一 种 默认 方法 实现 了 两 个 接口 ， 会 出 现 什么 情况 呢 ? 范例 5.5 将 讨论 这 
个 问题 ， 不 过 简 而 言 之 ， 类 可 以 实现 方法 本 身 。 详 细 信息 请 参见 范例 5.5。 


另 见 
范例 5.5 将 讨论 一 个 类 采用 默认 方法 实现 多 个 接口 时 需要 遵守 的 规则 。 


1.6 接口 中 的 静态 方法 


问题 

用 户 希 望 为 接口 添加 一 个 类 级 别 (class level) 的 工具 方法 和 相应 的 实现 。 

方案 

将 接口 方法 声明 为 static， 并 以 常规 方式 添加 实现 。 

讨论 

Java 类 的 静态 成 员 是 类 级 别 的 。 换 言 之， 静态 成 员 与 整个 类 相关 联 ， 而 不 是 与 特定 的 实例 
相关 联 。 但 从 设计 的 角度 看 ， 静 态 成 员 在 接口 中 的 使 用 是 有 问题 的 ， 举 例如 下 。 


。 当 多 个 不 同 的 类 实现 接口 时 ， 类 级 别 成 员 指 的 是 什么 ? 

。 类 是 否 需 要 通过 实现 接口 来 使 用 静态 方法 ? 

。 类 中 的 静态 方法 是 通过 类 名 访问 的 。 如 果 类 实现 了 一 个 接口 ， 那 么 静态 方法 是 通过 类 名 
还 是 接口 名 来 调用 呢 ? 


为 解决 这 些 问 题 ，Java 开发 团队 尝试 了 几 种 不 同 的 方案 。 


在 Java 8 之 前 ， 接 口 完 全 不 支持 使 用 静态 成 员 ， 不 过 这 导致 了 工具 类 的 产生 ， 这 是 一 种 只 包 
含 静 态 方 法 的 类 。java.util.Collections 就 是 一 种 典型 的 工具 类 ， 它 不 仅 包括 用 于 排序 和 搜 
索 的 方法 ， 也 定义 了 采用 同步 或 不 可 修改 的 类 型 包装 集合 的 方法 。 在 NI0 包 中 ， 另 一 种 工具 
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类 是 java.nio.fite.Paths， 它 只 包括 从 字符 串 或 URI 中 解析 Path 实例 的 两 个 静态 方法 。 

而 在 Java 8 中， 我 们 可 以 随时 为 接口 添加 静态 方法 ， 步 骤 如 下 。 

。 为 方法 添加 static 关键 字 。 

。 提供 一 种 无 法 被 重 写 的 实现 。 此 时 ， 静 态 方法 类 似 于 默认 方法 ， 包 含 在 Javadoc 的 Default 
Methods (默认 标签 ) 中 。 

。 通过 接口 名 访问 方法 。 类 不 需要 通过 实现 接口 来 使 用 静态 方法 。 

java.util.Comparator 接口 定义 的 comparing 方 法 就 是 一 种 实用 的 静态 方法 ， 它 包括 

comparingInt、comparingLong、comparingDouble 等 三 种 基本 变 体 。 此 外 ，Comparator 接口 

还 包括 naturaLorder 和 reverse0rder 两 种 静态 方法 。 例 1-28 给 出 了 这 些 方法 的 用 法 。 

例 1-28 字符 串 排序 


List<String> bonds = Arrays.asList("Connery", "Lazenby", "Moore", 
"Dalton", "Brosnan", "Craig"); 











List<String> sorted = bonds.stream() 
.sorted(Comparator .naturalOrder()) 0 
.Collect(Collectors. toList()); 

// [Brosnan, Connery, Craig, Dalton, Lazenby, Moore] 


sorted = bonds.stream() 
.sorted(Comparator .reverseOrder()) @ 
.collect(Collectors.toList()); 

// [Moore, Lazenby, Dalton, Craig, Connery, Brosnan] 


sorted = bonds.stream() 
.Sorted(Comparator .comparing(String::toLowerCase)) © 
.collect(Collectors.toList()); 

// [Brosnan, Connery, Craig, Dalton, Lazenby, Moore] 


sorted = bonds.stream() 
.Sorted(Comparator .comparingInt(String::length)) ©@ 
.collect(Collectors.toList()); 

// [Moore, Craig, Dalton, Connery, Lazenby, Brosnan] 


sorted = bonds.stream() 
.Sorted(Comparator .comparingInt(String::length) © 
.thenComparing(Comparator .naturalOrder())) 


.collect(Collectors. toList()); 
// [Craig, Moore, Dalton, Brosnan, Connery, Lazenby] 


@ 自然 顺序 (字典 序 ) 

@ 反 向 顺序 (字典 序 ) 

@ 按 小 写 名 称 排序 

@ 按 姓名 长 度 排序 

@ 按 姓名 长 度 排 序 ， 如 果 长 度 相 同 则 按 字典 序 排序 























: 











本 例 显 示 了 如 何 利 用 Comparator 接 


口 提供 的 静态 方法 对 一 份 演员 名 单 进行 排序 


现 的 演员 是 这 些 年 来 詹姆斯 . 邦 德 的 扮演 者 。” 有 关 比 较 器 的 详细 讨论 ，i 


由 于 接口 中 有 静态 方法 ， 我 们 不 必 全 


请 注意 以 下 儿 点 : 





。 静态 方法 必须 有 一 个 实现 

。 无 法 重 写 静 态 方法 

。 通过 接口 名 调用 静态 方法 

。 无 须 实现 接口 以 使 用 静态 方法 


另 见 


接口 中 静态 方法 的 应 用 贯穿 人 全书， 有关 Comparator 接口 定义 的 静态 方法 请 参见 范例 4.1。 





注 9: 我 差点 将 伊 德 




















消息 一 一 译 者 诗 


在 《 环 太平 六 





E£》《 和 雷神》 等 影片 中 饰演 的 角色 
FE,) 














消 斯 " 艾 尔 巴 (Idris Elba) 加 入 名 单 ， 但 总 算 忍 住 没 这 么 做 。 





为 影迷 所 熟知 ，2014 年 曾 传 








( 艾 尔 巴 是 英 


车 | 





， 名 单 中 出 
者 参见 范例 4.1。 


| 建 单独 的 工具 类 。 但 需要 的 话 ， 仍 然 可 以 创建 工具 类 。 


影星 ， 








他 将 出 演 下 一 任 邦 德 的 
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第 2 章 


java.util.function 包 





第 1 章 讨 论 了 1lambda 表达 式 和 方法 引用 的 基本 语法 ， 二 者 在 任何 情况 下 都 不 能 脱离 上 下 
文 (context) 而 存在 。lambda 表达 式 和 方法 引用 总 是 被 赋 给 函数 式 接 口 ， 它 提供 了 所 实现 
的 单一 抽象 方法 的 信息 。 

Java 标准 库 中 的 许多 接口 仅 包 含 一 个 抽象 方法 ， 它 们 属于 函数 式 接口 。 为 此 ，Java 8 专门 
定义 了 java.util.function 包 ， 它 仅 包 含 可 以 在 库 的 其 余部 分 重用 的 函数 式 接口 。 


java.util.function 包 中 的 接口 分 为 四 类 ， 分 别 是 Consumer (消费 型 接口 )、Supplier 
(供给 型 接口 )、Predicate (谓词 型 接口 ) 以 及 Function (功能 型 接口 ) 。Consumer 接口 传 
入 一 个 泛 型 参数 (generic argument)， 不 返回 任何 值 ，Supplier 接口 不 传人 人 参数， 返回 一 
个 值 ，Predicate 接口 传 入 一 个 参数 ， 返 回 一 个 布尔 值 ，Function 接口 传 入 一 个 参数 ， 返 
回 一 个 值 。 

每 种 基本 接口 还 包含 若干 相关 的 接口 。 以 Consumer 接口 为 例 ， 用 于 处 理 基本 数据 类 型 的 
是 IntConsumer、LongConsumer 和 DoubLeConsumer 接口 ，BiConsumer 接口 传 入 两 个 参数 并 
返回 void。 

虽然 根据 定义 ， 这 一 章 讨论 的 函数 式 接口 只 包含 一 个 抽象 方法 ， 但 大 部 分 接口 也 包含 声明 
为 static 或 default 的 方法 。 对 于 开发 人 员 而 言 ， 掌 握 这 些 方法 有 助 于 提高 工作 效率 。 


2.1 _ Consumer 接口 

















问题 
用 户 希望 编写 实现 java.util.function.Consumer 包 的 lambda 表达 式 。 
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方案 

使 用 lambda 表达 式 或 方法 引用 来 实现 void accept(T t) 方法 。 

讨论 

例 2-1 列 出 了 Consumer 接口 定义 的 方法 ， 其 单一 抽象 方法 为 votd accept(T t)。 
例 2-1 Consumer 接口 定义 的 方法 





void accept(T 七 ) 0 
default Consumer<T> andThen(Consumer<? super T> after) @ 
@ 单一 抽象 方法 


@ 用 于 复合 操作 的 默认 方法 
accept 方法 传 入 一 个 泛 型 参数 并 返回 votd。 在 所 有 传人 Consumer 作为 参数 的 方法 中 ， 最 
常见 的 是 java.util.Iterable 接口 的 默认 forEach 方法 ， 如 例 2-2 所 示 。 


例 2-2 Iterable 接口 定义 的 forEach 方法 


default void forEach(Consumer<? super T> action) © 
@ 将 可 友 代 集合 (iterable collection) 中 的 所 有 元 素 传递 给 Consumer 参数 
如 例 2-3 所 示 ， 所 有 线性 集合 通过 对 集合 中 每 个 元 素 执行 给 定 的 操作 来 实现 Iterable 接口 。 
例 2-3 打印 集合 中 的 元 素 


List<String> strings = Arrays.asList("this", 








is", a "list", "of "strings"); 


strings.forEach(new Consumer<String>() { 0 
@Override 
public void accept(String s) { 
System.out.println(s); 
} 
]); 


strings.forEach(s -> System.out.println(s)); ©@ 
strings.forEach(System.out: :println); 【3) 


@ 匿名 内 部 类 实现 
@ lambda 表达 式 
@ 方法 引用 
在 本 例 中 ， 由 于 accept 方法 只 传人 一 个 参数 且 不 返回 任何 值 ， 其 签名 与 lambda 表达 式 相 
符 。 通 过 System.out 访问 PrintStream 类 的 printtn 方法 ， 它 与 Consumer 相互 兼容 。 因 
此 ， 最 后 两 条 语句 都 可 以 作为 Consumer 参数 的 目标 。 

如 表 2-1 所 示 ，java.util.function 包 还 定义 了 三 种 Consumer<T> 的 基本 变 体 ， 以 及 一 种 双 
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表 2-1: 其 他 Consumer 接 口 





接口 单一 抽象 方法 
IntConsumer void accept(int x) 
DoubleConsumer void accept(double x) 
LongConsumer void accept(long x) 
BiConsumer void accept(T t, U U) 





Consumer 接口 期 望 执行 带 有 副作用 的 操作 ( 即 它 可 能 会 改变 输入 参数 的 内 部 
状态 ) ， 参 见 范例 2.3。 





BiConsumer 接口 的 accept 方法 传 入 两 个 泛 型 参数 ， 这 两 个 泛 型 参数 应 为 不 同 的 类 型 。 
java.util.function 包 定 义 了 BtConsumer 接口 的 三 种 变 体 ， 每 种 变 体 的 第 二 个 参数 为 基本 
数据 类 型 。 以 0bjIntConsumer 接口 为 例 ， 其 accept 方法 传人 两 个 参数 ， 分 别 为 泛 型 参数 
和 int 参数 。0bjLongConsumer 和 0bjDoubleConsumer 接口 的 定义 与 0bjIntConsumer 类 似 。 
标准 库 还 支持 Consumer 接口 的 一 些 其 他 用 法 。 


OptionaL.ifPresent(Consumer<? Super T> consumer) 
如 果 值 存在 ， 则 调用 指定 的 consumer ; 否则 不 进行 任何 操作 。 
Stream.forEach(Consumer<? super T> action) 
对 流 的 每 个 元 素 执 行 操作 '。Stream.forEachOrdered 方法 与 之 类 似 , 它 根 据 元 素 的 
序 (encounter order) 访问 元 素 。 











顺 


£5 
尘 


Stream.peek(Consumer<? super T> action) 
首先 执行 给 定 操作 ， 再 返回 一 个 与 现 有 流 包含 相同 元 素 的 流 。peek 方法 在 调试 中 极为 
有 用 (参见 范例 3.5)。 
另 见 
Consumer 接口 定义 的 andThen 方法 用 于 函数 复合 (function composition) ， 详 细 讨 论 参 见 范 
例 5.8。 有 关 Stream.peek 方法 的 讨论 参见 范例 3.5。 


2.2 Supplier 接 口 


问题 
用 户 希 望 实现 java.util.function.Supplier 接口 。 











注 1: 这 项 操作 十 分 常见 ， 因 此 Iterable 接口 也 直接 定义 了 forEach 方法 。 当 源 元 素 不 是 来 自 集合 或 需要 创 
建 并 行 流 时 ，Stream.forEach 方法 就 很 有 用 。 
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方案 


使 用 lambda 表达 式 或 方法 引用 来 实现 T get() 方法 。 


讨论 





Supplier 接口 相当 简单 ， 它 不 包含 任何 静态 或 默认 方法 ， 只 有 一 个 抽象 方法 T get()。 


为 实现 Supplier 接口 ， 需 要 提供 一 个 不 传 入 参数 且 返 回 泛 型 类 型 (generic type) 的 方法 。 
根据 Javadoc 的 描述 ， 调 用 Supplier 时 ， 不 要 求 每 次 都 返回 一 个 新 的 或 不 同 的 结果 。 


supplier 的 一 种 简单 应 用 是 Math.randon 方法 ， 它 不 传人 参数 且 返 回 double 型 数据 。 如 

















例 2-4 所 示 ，Math.randon 方法 可 以 被 赋 给 SuppLier 引用 并 随时 调用 。 


例 2-4 使 用 Math.random 作为 Supplier 
Logger Logger = Logger .getLogger("..."); 


DoubleSupplier randomSupplier = new DoubleSupplier() { © 
@Override 
public double getAsDouble() { 
return Math.random(); 


} 
}; 
randomSupplier = () -> Math.random(); © 
randomSupplier = Math::random; © 


Logger .info(randomSupplier); 
@ 匿名 内 部 类 实现 
@ lambda 表达 式 
@ 方法 引用 


DoubleSupplier 接口 包含 的 单一 抽象 方法 为 getAsDouble， 它 返回 
表 2-2 列 出 了 java.util.function 包 定 义 的 其 他 相关 Supplier 接口 。 


表 2-2: 其 他 SuppLier 接 口 

















接口 单一 抽象 方法 
IntSupplier int getAsInt() 
DoubleSupplier double getAsDouble() 
LongSupplier long getAsLong() 
BooleanSupplier boolean getAsBoolean() 





一 个 double 型 数据 。 


SuppLier 的 一 个 主要 用 例 是 延迟 执行 (deferred execution)。java.util.logging.Logger 类 
定义 的 info 方法 传人 SuppLiter， 仅 当日 志 级 别 (log level) 控制 日 志 消 息 可 见 时 ， 才 调用 
其 get 方法 ( 详 见 范例 5.7)。 用 户 可 以 在 自己 的 代码 中 应 用 延迟 执行 ， 以 确保 只 在 合适 的 

















情况 下 才 从 supplier 中 检索 值 。 
另 一 个 用 例 是 标准 库 中 java.util.0ptional 类 定义 的 orElseGet 方法 ， 





它 同样 传人 Supplier。 





java 
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有 关 0ptional 类 的 讨论 请 参见 第 6 章 ， 不 过 简 而 言 之 ，0ptionat 类 是 一 种 容器 对 象 
(container object) ， 要 么 包装 值 ， 要 么 为 空 。0ptionalt 类 通常 用 于 在 返回 值 可 能 合法 为 
null 时 与 用 户 进行 通信 ， 比 如 在 空 集中 查找 某 个 值 。 

我 们 以 在 一 个 集合 中 搜索 名 称 为 例 ， 展 示 以 上 方法 的 应 用 ， 如 例 2-5 所 示 。 


例 2-5 在 集合 中 查找 名 称 


List<String> names = Arrays.asList("Mal", "Wash", "Kaylee", "Inara", 
"Zoé", "Jayne", "Simon", "River", "Shepherd Book"); 











Optional<String> first = names.stream() 
.filter(name -> name.startsWith("C")) 
.findFirst(); 


System.out.println(first); 0 
System.out.println(first.orElse("None")); © 


System.out.println(first.orElse(String.format("No result found in %s", 
names.stream().collect(Collectors.joining(", "))))); © 


System.out.println(first.orElseGet(() -> 
String.format("No result found in %s", 
Names.stream().collect(Collectors.joining(", "))))); @ 
@ 打印 Optional.empty 
@ 打印 字符 串 "None" 
@ 即便 找到 指定 的 名 称 ， 仍 然 使 用 逗号 分 隔 集 合 
@ 仅 当 optionat 为 空 时 ， 才 使 用 逗号 分 隔 集 合 
Streanm 接口 的 findFirst 方法 将 返回 有 序 流 中 出 现 的 第 一 个 元 素 。” 由 于 可 以 将 流 中 的 元 素 
全 部 滤 掉 ，findFirst 方法 将 返回 一 个 Optional。O0ptional 要 么 包含 所 需 的 元 素 ， 要 么 为 
空 。 在 本 例 中 ， 由 于 列表 中 的 任何 名 称 都 不 会 传递 给 筛选 器 ， 所 以 结果 是 一 个 空 0ptional。 
Optional 类 的 orElse 方法 可 以 返回 包含 的 元 素 ， 或 者 可 以 返回 指定 的 默认 值 。 虽 然 默认 值 
为 简单 的 字符 串 并 无 不 妥 ， 但 如 果 需 要 经 过 处 理 才 能 返回 值 ， 则 简单 字符 串 的 意义 不 大 。 
在 本 例 中 ， 返 回 值 以 逗号 分 隔 的 形式 显示 了 名 称 的 完整 列表 。 无 论 0ptional 中 是 否 包含 
值 ，orElse 方法 都 会 创建 完整 的 字符 串 。 
而 orELseGet 方法 传人 Supplier 作为 参数 。 其 优点 在 于 ， 仅 当 0ptional 为 空 时 ， 才 会 调用 
Supptier 接口 的 get 方法 。 换 言 之 ， 除 非 确 有 必要 ， 和 否则 不 会 创建 完整 的 名 称 字符 审 。 
标准 库 还 支持 supptter 接口 的 其 他 一 些 用 法 。 
。 0ptional 类 的 orELseThrow 方法 传 入 SuppLier<X extends Exception>， 仅 当 发 生 异 常 时 
才 会 执行 Supplier。 
















































































了 











注 2: 流 可 能 存在 (也 可 能 不 存在 ) 出 现 顺序 ， 如 同 列表 被 假定 为 按 索引 排序 而 集合 不 是 。 这 与 元 素 的 处 理 
顺序 可 能 有 所 不 同 。 详 见 范例 3.9。 
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。 当 0bjects.requireNonNull(T obj，Supplier<String> messageSupplier) 的 第 一 个 参数 
为 空 时 ， 抛 出 自 定 义 的 NullPointerException。 

。 CompletableFuture.supplyAsync(Supplier<U> supplier) 返回 一 个 CompLetabLeFuture， 
它 通 过 调用 给 定 Supplier 获得 的 值 ， 以 使 得 运行 的 任务 异步 完成 。 

。 Logger 类 的 所 有 日 志 记录 方法 都 有 相应 的 重 载 形 式 ， 它 传 入 Supplier<string>， 而 不 仅 
仅 是 一 个 字符 串 〈 详 见 范例 5.7) 。 











另 见 

有 关 日 志 记 录 方 法 的 重 载 形式 〈 传 人 Supplier) 请 参见 范例 5.7， 有 关 查 找 集合 中 的 第 一 
个 元 素 请 参见 范例 3.9， 有 关 CompletableFuture 类 的 讨论 请 参见 第 9 章 ， 有 关 0ptional 类 
的 讨论 请 参见 第 6 章 。 


2.3 Predicate 接 口 


问题 

用 户 希 望 使 用 java.util.function.Predicate 接口 饰 选 数 据 。 

方案 

使 用 lambda 表达 式 或 方法 引用 来 实现 boolean test(T t) 方法。 

讨论 

Predicate 接口 主要 用 于 流 的 往 选 。 给 定 一 个 包含 若干 项 的 流 ，Streanm 接口 的 filter 方法 
传人 Predicate 并 返回 一 个 新 的 流 ， 它 仅 包含 满足 给 定 谓词 的 项 。 


Predicate 接口 包含 的 单一 抽象 方法 为 boolean test(T t)， 它 传 入 一 个 泛 型 参数 并 返回 
true 或 false。 例 2-6 列 出 了 Predicate 接口 定义 的 所 有 方法 (包括 静态 和 默认 方法 )。 


例 2-6 Predicate 接口 定义 的 方法 
default Predicate<T> and(Predicate<? Super T> other) 
static <T> Predicate<T> isEqual(Object targetRef) 
default Predicate<T> negate() 

















default Predicate<T> or(Predicate<? suyper T> other) 
boolean test(T t) 上 
@ 单一 抽象 方法 














给 定 一 个 名 称 集合 ， 可 以 通过 流 处 理 找 出 所 有 有 具有 特定 长 度 的 实例 ， 如 例 2-7 所 示 。 
例 2-7 查找 具有 给 定 长 度 的 字符 串 


public String getNamesOfLength(int length, String... names) { 
return Arrays.stream(names) 
.filter(s -> s.length() == length) © 
.collect(Collectors.joining(", ")); 
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@ 满足 给 定 长 度 字 符 串 的 谓词 
或 者 ， 我 们 也 可 能 只 需要 返回 以 特定 字符 串 开 头 的 名 称 ， 如 例 2-8 所 示 。 
例 2-8 查找 以 给 定 字 符 串 开头 的 字符 串 


public String getNamesStartingWith(String s, String... names) { 
return Arrays.stream(names) 
.filter(str -> str.startsWith(s)) © 
.collect(Collectors.joining(", ")); 











} 
@ 返回 以 给 定 字符 串 开头 的 字符 
如 果 允 许 客户 端 指定 条 件 ，Predicate 的 通用 性 会 更 强 。 例 2-9 显示 了 其 中 一 种 应 有 
例 2-9 查找 满足 任意 谓词 的 字符 囊 


public class ImpLementPredicate { 
public String getNamesSatisfyingCondition( 
Predicate<String> condition, String... names) { 
return Arrays.stream(names) 
.filter(condition) © 
.collect(Collectors.joining(", ")); 








Ud 





< 
o 


} 
// 其 他 方法 





} 
@ 根据 提供 的 谓词 进行 筛选 


上 述 用 法 相当 灵活 ， 但 依靠 客户 端 自己 编写 所 有 谓词 或 许 不 太 容 易 。 一 种 方案 是 将 常量 添 
加 到 代表 最 常见 情况 的 类 中 ， 如 例 2-10 所 示 。 


例 2-10 为 常见 情况 添加 常量 
public class ImpLementPredicate { 
public static final Predicate<String> LENGTH_FIVE = s -> s.length() == 5; 
public static final Predicate<String> STARTS_WITH_S = 
s -> s.startsWith("S"); 














// 其余 代码 和 之 前 一 样 





} 


提供 谓词 作为 参数 的 另 一 个 优点 是 ， 可 以 使 用 默认 方法 and、or 与 negate， 并 根据 一 系列 
单个 元 素来 创建 复合 谓词 (composite predicate)。 

例 2-11 的 测试 用 例 展 示 了 各 种 方法 的 应 用 。 

例 2-11 针对 谓词 方法 的 JUnit 测试 


import static functionpackage.ImplementPredicate.*; © 
import static org.junit.Assert.assertEquals; 





mp 

















// 其 他 导入 


public class ImpLementPredicateTest { 
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} 


private ImplementPredicate demo = new ImplementPredicate(); 
private String[] names; 


@Before 
public void setUp() { 
names = Stream.of("Mal", "Wash", "Kaylee", "Inara", "Zoé", 
"Jayne", "Simon", "River", "Shepherd Book") 
.Sorted() 
.toArray(String[]::new); 


} 


QTest 
public void getNamesOfLength5() throws Exception { 
assertEquals("Inara, Jayne, River, Simon", 
demo.getNamesOfLength(5, names)); 


} 


QTest 
public void getNamesStartingWithSs() throws Exception { 
assertEquals("Shepherd Book, Simon", 
demo.getNamesStartingWith("S", names)); 


} 


QTest 
public void getNamesSatisfyingCondition() throws Exception { 
assertEquals("Inara, Jayne, River, Simon", 
demo.getNamesSatisfyingCondition(s -> s.length() == 5, names)); 
assertEquals("Shepherd Book, Simon", 
demo.getNamesSatisfyingCondition(s -> s.startsWith("S"), 
names)); 
assertEquals("Inara, Jayne, River, Simon", 
demo.getNamesSatisfyingCondition(LENGTH_FIVE, names)); 
assertEquals("Shepherd Book, Simon", 
demo.getNamesSatisfyingCondition(STARTS_WITH_S, names)); 


} 


QTest 
public void composedPredicate() throws Exception { 
assertEquals("Simon", 
demo.getNamesSatisfyingCondition( 
LENGTH_FIVE.and(STARTS_WITH_S), names)); @ 
assertEquals("Inara, Jayne, River, Shepherd Book, Simon", 
demo.getNamesSatisfyingCondition( 
LENGTH_FIVE.or(STARTS_WITH_S), nanes)); ©@ 
assertEquals("Kaylee, Mal, Shepherd Book, Wash, Zoé", 


demo.getNamesSatisfyingCondition(LENGTH_FIVE.negate(), names)); © 


@ 静态 导入 让 使 用 常量 更 加 简单 


@ 复合 
@ 否定 
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标准 库 还 支持 Predicate 接口 的 其 他 一 些 用 法 。 
Optional.filter(Predicate<? super T> predicate) 


如 果 值 存在 且 匹 配 某 个 给 定 的 谓词 ， 则 返回 描述 该 值 的 Optional， 否 则 返回 一 个 空 
Optional, 


















































Collection.removeIf(Predicate<? super E> filter) 
删除 集合 中 所 有 满足 谓词 的 元 素 。 
Stream.allMatch(Predicate<? super T> predicate) 
如 果 流 的 所 有 元 素 均 满 足 给 定 的 谓词 ， 则 返回 true。anyMatch 和 noneMatch 方法 的 用 法 
与 之 类 似 。 
Collectors.partitioningBy(Predicate<? super T> predicate) 
返回 一 个 Collector， 它 将 流 分 为 两 类 (满足 谓词 和 不 满足 谓词 )。 
只 要 流 仅 返回 特定 的 元 素 ，Predicate 接口 就 很 有 用 。 和 希望 本 范例 能 对 读者 有 所 局 发 ， 理 
解 这 种 接口 的 用 法 。 








口 

另 见 

有 关闭 包 复 合 (closure composition) 的 讨论 请 参见 范例 5.8， 有 关 aLLMatch、anyMatch 与 
noneMatch 方法 的 讨论 请 参见 范例 3.10， 有 关 分 区 和 分 组 的 讨论 请 参见 范例 4.5。 


2.4 Function 接 口 


问题 

用 户 希望 实现 java.util.function.Function 接口 ， 以 便 将 输入 参数 转换 为 输出 值 。 

方案 

提供 一 个 实现 R apply(T t) 方法 的 lambda 表达 式 。 

讨论 

Function 接口 包含 的 单一 抽象 方法 为 apply， 它 可 以 将 T 类 型 的 泛 型 输入 参数 转换 为 R 类 
型 的 泛 型 输出 值 。 例 2-12 列 出 了 Function 接口 定义 的 所 有 方法 。 

例 2-12 ”Function 接口 定义 的 方法 


default <V> Function<T,V> andThen(Function<? suyper R,? extends V> after) 
R appLy(T t) 

default <V> Function<V,R> compose(Function<? suyper V,? extends T> before) 

static <T> Function<T,T> identity() 


Function 最 常见 的 用 法 是 作为 Stream.map 方法 的 一 个 参数 。 例 如 ， 为 了 将 string 转换 为 
整数 ， 可 以 在 每 个 实例 上 调用 Length 方法 ， 如 例 2-13 所 示 。 
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例 2-13 将 字符 串 映射 到 它们 的 长 度 


List<String> names = Arrays.asList("Mal", "Wash", "Kaylee", "Inara", 
"Zoé", "Jayne", "Simon", "River", "Shepherd Book"); 


List<Integer> nameLengths = names.stream() 
.map(new Function<String, Integer>() {©@ 
@Override 
public Integer apply(String s) { 
return s.length(); 
} 


}) 
.collect(Collectors.toList()); 


nameLengths = names.stream() 
.map(s -> s.Length()) (2) 
.collect(Collectors.toList()); 


nameLengths = names.stream() 
.map(String::length) 【3) 
.collect(Collectors.toList()); 


System.out.printf("nameLengths = %s%n", nameLengths); 
// nameLengths == [3, 4, 6, 5, 3, 5, 5, 5, 13] 


@ 匿名 内 部 类 

@ lambda 表达 式 
@ 方法 引用 
表 2-3 列 出 了 输入 和 输出 泛 型 类 型 的 所 有 基本 变 体 。 
表 2-3: 其 他 Function 接 口 














接口 单一 抽象 方法 

IntFunction R apply(int value) 
DoubleFunction R apply(double value) 
LongFunction R appLy(Long value) 
ToIntFunction int applyAsInt(T value) 
ToDoubleFunction double applyAsDouble(T value) 
ToLongFunction Long appLyAsLong(T value) 
DoubLeToIntFunction int applyAsInt(double value) 
DoubleToLongFunction Long applyAsLong(double value) 
IntToDoubleFunction double applyAsDouble(int value) 
IntToLongFunction Long applyAsLong(int value) 
LongToDoubleFunction double applyAsDouble(long value) 
LongToIntFunction int appLyAsInt(Long value) 
BiFunction R apply(T t, U u) 




















在 例 2-13 中 ， 由 于 map 方法 返回 的 是 基本 数据 类 型 int， 该 方法 的 参数 可 能 是 ToIntFunction。 


Stream.mapToInt 方法 传 入 ToIntFunction 作为 参数 ，mapToDouble 和 mapToLong 方法 与 之 类 似 。 





java.util.function 包 
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mapToInt、mapToDouble 与 mapToLong 的 返回 类 型 分 别 为 IntStream、DoubleStream 和 LongStream。 


那么 ， 如 果 输 入 参数 和 返回 类 型 相同 呢 ? java.util.function 包 为 此 定义 了 UnaryOperator 接 
口 ， 以 及 相应 的 IntUnary0perator、DoubLeUnary0perator 和 LongUnaryOperator 接口 ， 三 者 的 
输入 和 输出 参数 分 别 为 int、double 和 Long。Unary0perator 的 一 种 应 用 是 StringBuilder 
的 reverse 方法 ， 因 为 输入 类 型 和 输出 类 型 均 为 字符 串 。 

BiFunction 接口 定义 了 两 个 泛 型 输入 类 型 和 一 个 泛 型 输出 类 型 ， 三 者 应 为 不 同 的 类 型 。 如 果 
三 者 相同 ， 可 以 使 用 java.util.function 包 定 义 的 BinaryOperator 接口 。Math.max 就 是 一 
种 二 元 运算 符 ， 其 输入 和 输出 为 int、double、float 或 Long 型 数据 。 相 应 地 ，java.util. 
function 包 也 定义 了 IntBinaryOperator、DoubleBinaryOperator 与 LongBinary0perator 
接口 。” 

表 2-4 列 出 了 BiFunction 接口 的 所 有 基本 变 体 。 

表 2-4:， 其 他 BiFunction 接 口 















































接口 单一 抽象 方法 

ToIntBiFunction int applyAsInt(T t, U u) 
ToDoubleBiFunction double applyAsDouble(T t, U u) 
ToLongBiFunction Long applyAsLong(T t, U u) 





尽管 Function 主要 用 于 各 种 Stream.map 方法 ， 但 这 些 方法 也 可 能 出 现在 其 他 上 下 文中 ， 
举例 如 下 。 
Map.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction) 
如 果 指 定 的 键 没有 值 ， 使 用 所 提供 的 Function 计算 一 个 值 并 将 其 添加 到 Map。 
Comparator .comparing(Function<? super T,? extends U> keyExtractor) 
comparing 方法 生成 一 个 Comparator ， 使 用 给 定 Function 生成 的 键 对 集合 进行 排序 。 相 
关 讨 论 请 参见 范例 4.1。 
Comparator.thenComparing(Function<? super T,? extends U> keyExtractor) 
thenComparing 是 一 种 实例 方法 ， 也 可 以 用 于 排序 。 如 果 集 合 的 首次 排序 返回 相同 的 值 ， 
则 使 用 另 一 种 机 制 进行 排序 。 


此 外 ，Function 还 广泛 用 于 分 组 和 下 游 收 集 器 (downstream collector) 的 CoLLectors 工具 
类 中 。 

有 关 andThen 和 compose 方法 的 讨论 请 参见 范例 5.8。identity 方法 实际 上 是 一 种 简单 的 
lambda 表达 式 (e -> e)， 范 例 4.3 将 介绍 其 中 一 种 应 用 。 





这 
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另 见 

有 关 Function.andThen 和 Function.compose 方法 的 应 用 请 参见 范例 5.8， 有 关 Function. 
identity 方 法 的 应 用 请 参见 范例 43， 有 关 下 游 收 集 器 的 讨论 请 参见 范例 46， 有 关 
computeIfAbsent 方法 的 讨论 请 参见 范例 5.4， 有 关 二 元 运算 符 的 讨论 请 参见 范例 3.3。 











注 3: 有 关 Java 标准 库 中 Binary0perator 用 法 的 详细 讨论 ， 请 参见 范例 3.3。 
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第 3 章 


流 式 操作 





为 支持 函数 式 编程 ，Java 8 引入 了 新 的 流 式 隐喻 (streaming metaphor)。 流 是 一 种 元 素 序 
列 ， 它 不 存储 元 素 ， 也 不 会 修改 原始 源 。Java 的 函数 式 编程 通常 涉及 从 某 些 数据 源 生成 
流 ， 通 过 一 系列 称 为 流水 线 (pipeline) 的 中 间 操 作 (intermediate operation) 传递 元 素 ， 并 
利用 终止 表达 式 (terminal expression) 完成 这 一 过 程 。 


流 仅 能 使 用 一 次 。 换 言 之 ， 流 在 经 过 零 个 或 多 个 中 间 操 作 并 达到 终止 操作 (terminal 
operation) 后 就 会 结束 。 如 果 希 望 再 次 对 值 进行 处 理 ， 需 要 创建 一 个 新 的 流 。 


此 外 ， 流 是 惰性 的 (lazy)。 也 就 是 说 ， 流 在 达到 终止 条 件 (terminal condition) 后 才 处 理 
数据 。 范 例 3.13 将 讨论 惰性 流 在 实际 中 的 应 用 。 


本 章 的 范例 将 介绍 各 种 典型 的 流 操 作 。 
3.1 流 的 创建 

问题 

用 户 希 望 从 数据 源 创建 流 。 

方案 


使 用 java.util.stream.Streanm 接口 定义 的 各 种 静态 工厂 方法 ， 以 及 java.lang.Iterable 
接口 或 java.util.Arrays 类 定义 的 strean 方法 。 























31 


讨论 


Java 8 引入 的 Stream 接口 定义 了 多 种 用 于 创建 流 的 静态 方法 。 具 体 而 言 ， 可 以 采用 Stream.of、 
Stream.iterate、Stream.generate 等 静态 方法 创建 流 。 


Stream.of 方法 传人 元 素 的 可 变 参 数列 表 : 


static <T> Stream<T> of(T... values) 


在 Java 标准 库 中 ，of 方法 的 实现 实际 上 被 委托 给 java.util.Arrays 类 定义 的 strean 方法 ， 
如 例 3-1 所 示 。 


例 3-1 Stream.of 方法 的 引用 实现 
@SafeVarargs 
public static<T> Stream<T> of(T... values) { 
return Arrays.stream(values); 
} 





@SafeVarargs 注解 属于 Java 泛 型 的 一 部 分 ， 它 在 使 用 数组 作为 参数 时 出 现 。 
因为 用 户 有 可 能 将 一 个 类 型 化 数组 〈typed array) 赋 给 一 个 0bject 数组 ， 导 
致 添加 的 元 素 引 发 类 型 安全 问题 。 换 言 之 ，@SafeVarargs 注解 构成 了 开发 人 
员 对 类 型 安全 的 承诺 。 详 见 附录 A。 











Stream.of 方法 的 简单 应 用 如 例 3-2 所 示 。 








由 于 流 在 遇 到 终止 表达 式 之 前 不 会 处 理 任何 数据 ， 本 范例 中 的 所 有 示例 都 会 
在 末尾 添加 一 个 终止 方法 ， 如 collect 或 forEach。 


例 3-2 利用 stream.of 方法 创建 流 


String names = Stream.of("Gomez", "Morticia", "Wednesday", "Pugsley") 
.Collect(Collectors.joining(",")); 

System.out.println(names); 

// 打 EllGomez,Morticia,Wednesday,Pugsley 


Java API 还 定义 了 of 方法 的 重 载 形式 ， 它 传 入 单个 元 素 T t， 返 回 只 包含 一 个 元 素 的 单 例 


顺序 流 (singleton sequential stream ) 。 
Arrays.strean 方法 的 应 用 如 例 3-3 所 示 。 
例 3-3 利用 Arrays.strean 方法 创建 流 


String[] munsters = { "Herman", "Lily", "Eddie", "Marilyn", "Grandpa" }; 
names = Arrays.stream(munsters) 
.Collect(Collectors.joining(",")); 
System.out.println(names); 
// 打 EllHerman,Lily,Eddie,Marilyn,Grandpa 





由 于 需要 提前 创建 数组 ， 上 述 方案 略 有 不 便 ， 但 足以 满足 可 变 参数 列表 的 需要 。Java API 
定义 了 Arrays.strean 方法 的 多 种 重 载 形式 ， 用 于 处 理 int、Long 和 double 型 数组 ， 还 定 
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义 了 本 例 使 用 的 泛 型 类 型 。 
Strean 接口 定义 的 另 一 种 静态 工厂 方法 是 iterate， 其 签名 如 下 : 


static <T> Stream<T> iterate(T seed, UnaryOperator<T> f) 


根据 Javadoc 的 描述 ，iterate 方 法 “返回 一 个 无 限 顺 序 的 有 序 流 (infinite sequential 
ordered stream) ， 它 由 运 代 应 用 到 初始 元 素 种 子 的 国 数 了 产生”。 回 顾 一 下 范例 2.4 讨论 的 
UnaryOperator， 它 是 一 种 函数 式 接 口 ， 其 输入 参数 和 输出 类 型 相同 。 如 果 有 办 法 根据 当前 
值 生 成 流 的 下 一 个 值 ，iterate 方法 将 相当 有 用 ， 如 例 3-4 所 示 。 


例 3-4 利用 Stream.iterate 方法 创建 流 
List<BigDecimal> nums = 
Stream.iterate(BigDecimal.ONE, n -> n.add(BigDecimal.ONE) ) 
.limit(10) 
.collect(Collectors.toList()); 
System.out.println(nums); 
// 打 EN[1, 2, 3, 4, 5, 6, 7, 8, 9, 10] 














Stream.iterate(LocalDate.now(), ld -> ld.plusDays(1L)) 
.limit(10) 
.forEach(System.out::println) 
// 打印 从 当日 开始 之 后 的 10 天 
一 段 代码 采 用 BigDecimal 实例 ， 从 1 开始 递增 。 第 二 段 代 码 采 用 java.time 包 新 增 的 
LocalDate 类 ， 从 当日 开始 按 天 递增 。 re et 需要 通过 中 间 操 作 
Limit 加 以 限制 。 


Streanm 接口 还 定义 了 静态 工厂 方法 generate， 其 签名 为 : 
static <T> Stream<T> generate(Supplier<T> s) 


generate 方法 通过 多 次 调用 Supplier 产生 一 个 顺序 的 无 序 流 (sequential, unordered stream ) 。 
在 Java 标准 库 中 ，Supplier 的 一 种 简单 应 用 是 Math.randon 方法 ， 它 不 传人 参数 而 返 
double 型 数据 ， 如 例 3-5 所 示 。 


例 3-5 利用 Math.randon 创建 随机 流 (double 型 ) 
Long count = Stream.generate(Math::random) 
.limit(10) 
.forEach(System.out::println) 


如 果 已 有 集合 ， 可 以 利用 CoLLection 接口 新 增 的 默认 方法 stream， 如 例 3-6 所 示 。， 
例 3-6 从 集合 创建 流 


List<String> bradyBunch = Arrays.asList("Greg", "Marcia", "Peter", "Jan", 
"Bobby", "Cindy"); 

names = bradyBunch.stream() 
OlleCt(COLLECtone. joining(",")); 

System.out.println(names); 

// 打印 Greg,Marcia,Peter,]an,Bobby,Cindy 























回 






































注 1: 希望 承认 以 下 事实 不 会 让 我 的 声誉 毁 于 一 旦 :我 随口 就 能 叫 出 《 脱 线 家 族 》 中 六 个 孩子 的 姓名 。 真 的 ， 
人 好， 
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Streanm 接口 定义 了 三 种 专门 用 于 处 理 基 本 数据 类 型 的 子 接口 ， 它 们 是 IntStream、LongStreanm 
和 DoubleStream。IntStream 和 LongStreanm 还 包括 另外 两 种 创建 流 所 用 的 工厂 方法 range 和 
rangeCLosed， 二 者 的 方法 签名 如 下 ; 

static IntStream range(int startInclusive, int endExclusive) 

static IntStream rangeClosed(int startInclusive, int endInclusive) 


static LongStream range(Long startInclusive, long endExclusive) 
static LongStream rangeClosed(long startInclusive, long endInclusive) 


注意 这 几 个 语句 中 的 参数 有 所 不 同 : rangeClosed 包含 终 值 (end value)， 而 range 不 包含 
终 值 。 两 种 方法 都 返回 一 个 顺序 的 有 序 流 ， 从 第 一 个 参数 开始 逐一 递增 。 例 3-7 展示 了 
range 和 rangeClosed 方法 的 应 用 。 


例 3-7 range 和 rangeClosed 方法 
List<Integer> ints = IntStream.range(10, 15) 
.boxed() 目 
.collect(Collectors.toList()); 
System.out.println(ints); 
// 打 EN[10, 11, 12, 13, 14] 


























List<Long> longs = LongStream.rangeClosed(10, 15) 
.boxed() © 
.collect(Collectors.toList()); 
System.out.printLn(Longs ) ; 
// 打 EN[10, 11, 12, 13, 14, 15] 


@ Collectors 需要 将 基本 数据 类 型 转换 为 List<T> 

本 例 唯一 的 奇怪 之 处 在 于 使 用 了 boxed 方法 将 int 值 转换 为 Integer 实例 。 有 关 boxed 方 
法 的 详细 讨论 请 参见 范例 3.2。 

创建 流 所 用 的 方法 总 结 如 下 。 

。 Stream.of(T... values) 和 Stream.of(T t) 

。 Arrays.stream(T[] array) 以 及 用 于 处 理 int[]、double[] 与 Long[] 型 数组 的 重 载 形式 


。 Stream.iterate(T seed, UnaryOperator<T> f) 



































。 Stream.generate(Supplier<T> s) 
。 Collection.stream() 
。 使 用 range 和 rangeClosed 方法 : 
— IntStream.range(int startInclusive, int endExclusive) 
— IntStream.rangeClosed(int startInclusive, int endInclusive) 
— LongStream.range(long startInclusive, long endExclusive) 
— LongStream.rangeClosed(long startInclusive, long endInclusive) 


另 见 
流 的 应 用 贯穿 全 书 。 有 关 将 基本 类 型 流转 换 为 包装 器 实例 (wrapper instance) 的 讨论 请 参 
见 范例 3.2。 














用 户 希望 利用 基本 类 型 流 (Primitive stream) 创建 集合 。 


方案 
既 可 以 使 用 java.util.stream.IntStreanm 接口 定义 的 boxed 方法 来 包装 元 素 ， 也 可 以 使 用 
合适 的 包装 器 类 (wrapper class) 来 映射 值 ， 还 可 以 使 用 coLLect 方法 的 三 参数 形式 。 

















讨论 
在 处 理 对 象 流 (object stream) 时 ， 可 以 通过 Collectors 类 提供 的 某 种 静态 方法 将 流转 换 
为 集合 。 例 如 ， 对 于 一 个 给 定 的 字符 串 流 ， 了 3-8 显示 了 如 何 创 建 List<String>。 
例 3-8 将 字符 串 流 转换 为 列表 

List<String> strings = Stream.of("this", "is", "a", "list", "of", "strings") 

.collect(Collectors. toList()); 

然而 ， 同 样 的 过 程 并 不 适合 处 理 基本 类 型 流 ， 例 3-9 中 的 代码 无 法 编译 。 
例 3-9 将 int 流转 换 为 Integer 列表 (无 法 编译 ) 


IntStream.of(3，1，4，1，5，9) 
.COLLect(CoLLectors.toList()); // 无 法 编译 


有 三 种 替代 方案 可 以 解决 这 个 问题 。 第 一 种 方案 是 利用 boxed 方法 ， 将 IntStreanm 转换 为 
Stream<Integer>， 如 例 3-10 所 示 。 
例 3-10 使 用 boxed 方法 

List<Integer> ints = IntStream.of(3, 1, 4, 1, 5, 9) 


.boxed() © 
.Collect(Collectors. toList()); 


@ 将 int 转换 为 Integer 


第 二 种 方案 是 利用 mapTo0bj 方法 ， 将 基本 类 型 流 中 的 每 个 元 素 转 换 为 包装 类 的 一 个 实例 ， 
如 例 3-11 所 示 。 


例 3-11 使 用 mapTo0bj 方法 
List<Integer> ints = IntStream.of(3, 1, 4, 1, 5, 9) 
.mapToObj(Integer: :valueOf) 
.collect(Collectors.toList()) 


mapToInt、mapToLong 和 mapToDouble 方法 将 对 象 流 解析 为 相关 的 基本 类 型 流 ， 与 之 类 似 ， 
IntStream、LongStreanm 与 DoubleStreanm 中 的 mapTo0bj 方法 将 基本 类 型 流转 换 为 相关 包装 
类 的 实例 。 在 本 例 中 ，mapTo0bj 方法 的 参数 为 Integer 类 定义 的 静态 方法 vaLue0f 。 
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出 于 性 能 方面 的 考虑 ， 构 造 函 数 Integer(int val) 已 被 JDK 9 弃 用 ， 建议 改 
用 Integer.value0f(int)。 

















第 三 种 方案 是 采用 collect 方法 的 三 参数 形式 ， 其 签名 为 : 


<R> R collect(Supplier<R> supplier, 
ObjIntConsumer<R> accumulator, 
BiConsumer<R,R> combiner) 


collect 方法 的 用 法 如 例 3-12 所 示 。 
例 3-12 使 用 collect 方法 的 三 参数 形式 


List<Integer> ints = IntStream.of(3, 1, 4, 1, 5, 9) 
.collect(ArrayList<Integer>::new, ArrayList::add, ArrayList::addAll); 





如 例 所 示 ，Supplier 是 ArrayList<Integer> 的 构造 函数 。 累 加 器 (accumulator) 为 add 方 
法 ， 表 示 如 何 为 列表 诡 加 单个 元 素 。 仅 在 并 行 操 作 中 使 用 的 组 合 器 (combiner) 是 addALL 
方法 ， 它 能 将 两 个 列表 合 二 为 一 。 尽 管 collect 的 三 参数 形式 并 不 和 常见， 但 理解 其 用 法 对 
开发 很 有 好 处 。 

以 上 三 种 方案 均 无 不 受 ， 采 用 哪 种 方案 取决 于 开发 人 员 的 编程 风格 。 

此 外 ， 如 果 希 望 将 流转 换 为 数组 而 非 列 表 ， 那 么 采用 toArray 方法 也 不 错 ， 如 例 3-13 所 示 。 


例 3-13 将 IntSstream 转换 为 tntArray 
int[] intArray = IntStream.of(3, 1, 4, 1, 5, 9).toArray(); 


本 范例 讨论 的 三 种 方案 都 是 必 不 可 少 的 ， 这 是 Java 最 初 将 基本 数据 类 型 与 对 象 区 别 对 待 的 
结果 ， 因 泛 型 的 引入 而 变 得 复杂 。 不 过 , 一旦 掌握 要 领 ， 使 用 boxed 或 mapTo0bj 方法 还 是 
很 容易 的 。 






































另 见 
有 关 收 集 器 的 讨论 请 参见 第 4 章 ， 有 关 构 造 国 数 引用 的 讨论 请 参见 范例 1.3。 


3.3 利用 reduce 方 法 实现 归 约 操作 
问题 

用 户 希 望 通过 流 操作 生成 单一 值 。 

方案 


使 用 reduce 方法 对 每 个 元 素 进行 累加 计算 。 





讨论 

Java 的 国 数 式 范 式 经 常 采用 “映射 - 和 萌 选 - 归 约 ”(map-fitLter-reduce) 的 过 程 处 理 数 据 。 
首先 ，map 操作 将 一 种 类 型 的 流转 换 为 另 一 种 类 型 (如 通过 调用 Length 方法 将 String 流转 
换 为 int 流 )。 ss fiLter 操作 产生 一 个 新 的 流 ， 它 仅 包 含 所 需 的 元 素 (如 长 度 小 于 
某 个 国 值 的 字符 串 ) 。 通过 终止 操作 从 流 中 生成 单个 值 (如 长 度 的 总 和 或 均值 )。 


1. 内 置 归 约 操作 

基本 类 型 流 IntStream、LongStream 和 DoubLeStream 定义 了 多 种 内 置 在 API 中 的 归 约 操作 。 
例如 ， 表 3-1 列 出 了 IntStrean 接口 定义 的 归 约 操作 。 

表 3-1: IntStreanm 接 口 定 义 的 归 约 操作 














TI 








方法 返回 类 型 

average OptionalDouble 

count Long 

maX OptionalInt 

min OptionalInt 

sum int 
summaryStatistics IntSummaryStatistics 


collect(Supplier<R> supplier, ObjIntConsumer<R> R 
accumulator, BiConsumer<R,R> combiner) 


reduce int, OptionalInt 


sum、count、max、min、average 等 归 约 操作 的 用 途 不 言 自明 。 有 趣 的 是 ， 如 果 流 中 没有 元 
素 (如 经 过 筛选 操作 后 )， 结 果 为 空 或 未 定义 ， 以 上 提 到 的 某 些 方 法 将 返回 0ptional。 


例 3-14 显示 了 处 理 字 符 串 集合 长 度 的 归 约 操作 。 
例 3-14 Intstrean 接口 的 归 约 操作 





String[] strings = "this is an array of strings".split(" "); 
Long count = Arrays.stream(strings) 

.map(String: :Length) 0 

.Count(); 


System.out.println("There are " + count + " strings"); 
int totalLength = Arrays.stream(strings) 
.mapToInt(String::Length) @ 
.Sum(); 
System.out.println("The total Length is " + totalLength); 


OptionalDouble ave = Arrays.stream(strings) 
.mapToInt(String: :length) @ 
.average(); 

System.out.println("The average length is 


+ ave); 


OptionalInt max = Arrays.stream(strings) 
.mapToInt(String::Length) @ 
.max(); 日 
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OptionalInt min = Arrays.stream(strings) 
.mapToInt(String::Llength) @ 
.min(); 【3) 


System.out.println("The max and min lengths are " + max + " and " + min); 
@ count 是 Strean 接口 定义 的 一 种 方法 ， 因 此 无 须 将 其 映射 给 IntStreanm 

@ sum 和 average 方法 仅 用 于 处 理 基 本 类 型 流 

@ 不 带 Comparator 的 max 和 min 方法 仅 用 于 处 理 基 本 类 型 流 

上 述 程 序 的 打印 结果 如 下 : 


There are 6 strings 

The total length is 22 

The average Length is OptionalDouble[3.6666666666666665] 

The max and min Lengths are OptionalInt[7] and OptionalInt[2] 


注意 ，average、max 与 min 方法 返回 0ptional， 因 为 原则 上 可 以 通过 应 用 一 个 入 选 器 来 删 
除 流 中 的 所 有 元 素 。 


count 方法 相当 有 趣 ， 相 关 讨论 请 参见 范例 3.7。 


Streanm 接口 定义 了 max(Comparator) 和 min(Comparator) 方法 ， 其 中 比较 器 用 于 确定 最 大 元 
素 和 最 小 元 素 。 而 在 IntStreanm 接口 中 ， 由 于 比较 操作 采用 整数 的 自然 顺序 完成 ， 两 种 方 
法 的 重 载 形式 均 不 需要 参数 。 

有 关 summaryStatistics 方法 的 讨论 请 参见 范例 3.8。 


表 3-1 中 列 出 的 最 后 两 种 归 约 操作 collect 和 reduce 值得 进一步 讨论 。collect 方法 的 应 

用 贯穿 全 书 ， 其 作用 是 将 流转 换 为 集合 ， 通 常 与 Collectors 类 定义 的 某 种 静态 辅助 方法 配 
合 使 用 〈 如 toList 或 toSet)。 但 是 ， 无 法 在 基本 类 型 流 中 使 用 collect 方法 的 三 参数 形 
式 ， 即 传 入 三 个 参数 ， 分 别 是 用 于 填充 的 集合 、 为 集合 添加 单个 元 素 的 累加 器 以 及 为 集合 
添加 多 个 元 素 的 组 合 袁 。 有 关 这 种 形式 的 讨论 请 参见 范例 3.2。 


2. 基本 归 约 实现 
在 实际 接触 到 reduce 方法 之 前 ， 这 种 方法 看 起 来 可 能 不 太 直 观 。 
IntStreanm 接口 定义 了 reduce 方法 的 两 种 重 载 形式 : 


OptionalInt reduce(IntBinaryOperator op) 
int reduce(int identity, IntBinaryOperator op) 






































第 一 条 语句 传 入 IntBinary0perator 并 返回 0ptionaLInt， 第 二 条 语句 需要 提供 identity 
(int 型) 以 及 IntBinaryOperator 。 


读者 或 许 还 记得 java.util.function.BiFunction 接口 ， 它 传人 两 个 参数 并 返回 一 个 值 ， 三 
者 的 类 型 可 以 不 同 。 如 果 输 入 类 型 和 返回 类 型 相同 ， 则 函数 为 BinaryOperator (如 Math. 
max)。 注 意 ，IntBinaryOperator 属于 Binary0perator， 其 输入 和 输出 类 型 均 为 int。 

那么 ， 在 不 使 用 sun 的 情况 下 ， 如 何 实现 整数 的 求 和 呢 ? 一 种 方案 是 利用 reduce 方法 ， 如 
例 3-15 所 示 。 
































例 3-15 利用 reduce 方法 求 和 
int Sum = IntStream.rangeClosed(1, 10) 
.reduce((x, y) -> x + y).orElse(0); 目 


@ sun 的 值 为 55 


编写 代码 时 ， 通 常 采用 垂直 方式 安排 流 的 流水 线 (stream pipeline) ， 这 是 基 
于 流畅 (fluent) API 的 一 种 方案 ， 其 中 一 个 方法 的 结果 将 作为 下 一 个 方法 的 
目标 。 在 本 例 中 ， 因 为 reduce 方法 返回 的 不 是 流 ， 所 以 将 orELse 置 于 同一 
于 (而 非 另 起 一 行 )， 它 不 属于 流水 线 的 一 部 分 。 不 过 这 只 是 为 了 方便 起 见 ， 
读者 可 以 根据 需要 使 用 任何 格式 。 




















在 本 例 中 ，IntBinaryOperator 由 lambda 表达 式 提供 ， 它 传 入 两 个 int 型 数据 并 返回 二 
之 和 。 不 难 想 象 ， 如 果 为 IntBinary0perator 添加 一 个 秘 选 器 ， 流 是 可 以 为 空 的 ， 其 结 
是 0ptionalInt。 之 后 的 orElse 方法 表明 ， 如 果 流 中 没有 元 素 ， 返 回 值 应 该 为 0。 

在 lambda 表达 式 中 ， 可 以 将 二 元 运算 符 的 第 一 个 参数 视 为 累加 器 ， 第 二 个 参数 视 为 流 中 
每 个 元 素 的 值 。 通 过 逐一 打印 各 个 元 素 能 很 容易 理解 这 一 点 ， 如 例 3-16 所 示 。 


例 3-16 打印 x 和 yy 的 值 
int sum = IntStream.rangeClosed(1, 10) 
.reduce((x, y) -> { 
System.out.printf("x=%d, y=%d%n", x, y); 
return Xx + y; 
}).orElse(0); 


输出 如 例 3-17 所 示 。 
例 3-17 ”逐一 打印 每 个 值 的 输出 


者 
果 

















IILIL IN UN INIL 人 
忆 \D co ~ 中 


© 


sum=55 
观察 以 上 输出 可 知 ,，x 和 y 的 初始 值 是 范围 内 的 前 两 个 值 。 二 元 运算 符 返 回 的 值 在 下 一 次 
迭代 时 变 为 x (累加 器 ) 的 值 ， 而 y 依次 传 入 流 的 每 个 值 。 


那么 ， 项 汪 我 们 融 户 才 处 理 皇 个 引 玫 ， 然后 再 求 和 呢 ? 例如 ， 在 求 和 之 前 将 所 有 的 数字 增 
加 一 倍 。 我 们 可 能 会 写 出 如 例 3-18 所 示 的 代码 ， 不 过 代码 看 似 正 确 ， 实 则 有 误 。 























注 2: 可 以 采用 多 种 方式 解决 这 个 问题 ， 包 括 将 sun 方法 返回 的 值 增加 一 倍 。 这 里 介绍 的 方案 演示 了 如 何 使 
用 双 参 数 形式 的 reduce 方法 。 
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例 3-18 在 求 和 过 程 中 将 值 增加 一 倍 〈 代 码 错误 ) 
int doubleSum = IntStream.rangeClosed(1, 10) 
.reduce((x, y) -> x + 2 * y).orElse(0); 目 





@ doublesun 的 值 为 109 ( 少 了 1) 


从 1 到 10 的 各 个 整数 之 和 为 55， 因 此 增加 一 倍 后 的 值 应 为 110， 但 本 例 的 计算 结果 却 是 
109。 问 题 出 在 reduce 方法 的 lambda 表达 式 上 : x 和 ?的 初始 值 为 1 和 2 ( 流 的 前 两 个 
值 )。 换 言 之 ， 流 的 第 一 个 值 不 会 增加 一 倍 。 


可 以 采用 reduce 方法 的 重 载 形式 解决 这 个 同 题 ， 也 就 是 为 累加 器 传人 一 个 初始 值 。 正 确 的 
代码 如 例 3-19 所 示 。 


例 3-19 在 求 和 过 程 中 将 值 倍增 (代码 正确 ) 
int doubleSum = IntStream.rangeClosed(1, 10) 
.reduce(0, (x, y) ->x+2*y); @ 


@ doubleSun 的 值 为 110 (这 才 是 正确 的 值 ) 


通过 将 累加 器 x 的 初始 值 设置 为 0，y 的 值 被 赋 给 流 中 的 各 个 元 素 ， 从 而 实现 所 有 元 素 增加 
一 倍 。 例 3-20 显示 了 每 次 迭代 时 x 和 y 的 值 。 


例 3-20 每 次 友 代 时 lambda 参数 的 值 
Acc=0，n=1 
Acc=2,， 
Acc=6,， 
Acc=12,， 
Acc=20,， 
Acc=30 ， 
Acc=42,， 
AccCc=56 ， 
Acc=72， 
Acc=90 ， 
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sum=110 


注意 ， 当 使 用 具有 累加 器 初始 值 的 reduce 方法 时 ， 返 回 类 型 是 int 而 非 OptionalInt。 

















二 元 运算 符 的 标识 值 
本 范例 中 的 示例 将 第 一 个 参数 称 为 累加 器 的 初始 值 (initial value) ， 不 过 方法 签名 将 其 
称 为 标识 值 (identity value) 。 关 键 字 identity 表示 应 该 为 二 元 运算 符 提 供 一 个 值 ， 以 
便 与 其 他 值 结合 时 返回 另 一 个 值 。 加 法 操作 的 标识 值 为 0， 乘 法 操作 的 标识 值 为 1， 字 
符 串 拼接 操作 的 标识 值 为 空 字 符 事 。 
本 节 讨 论 的 求 和 操作 并 无 不 同 ， 但 需要 注意 的 是 ， 应 将 计划 用 作 二 元 运算 符 的 任何 操 
作 的 标识 值 作 为 reduce 方法 的 第 一 个 参数 ， 即 为 累加 器 内 部 的 初始 值 。 


























Java 标准 库 提 供 了 多 种 归 约 方法 ， 但 如 果 这 些 方法 都 无 法 直接 解决 开发 中 遇 到 的 问题 ， 不 
妨 试 试 本 节 讨 论 的 两 种 reduce 方法 。 

3. Java 标 准 库 中 的 二 元 运算 符 

标准 库 引 入 的 一 些 新 方法 使 归 约 操作 变 得 特别 简单 。 例 如 ，Integer、Long 和 Double 类 都 
定义 了 sun 方法， 其 作用 就 是 对 两 数 求 和 。Integer 类 中 sun 方法 的 实现 如 下 所 示 : 


public static int sum(int a, int b) { 
return a + b; 











} 
那么 ， 为 什么 要 专门 定义 一 种 只 为 实现 两 个 整数 求 和 的 方法 呢 ? 这 是 因为 sun 方法 属于 
BinaryOperator (更 确切 地 说 ， 属 于 IntBinary0perator)， 很 容易 就 能 用 于 reduce 方法 ， 
如 例 3-21 所 示 。 
例 3-21 利用 三 元 运算 符 执行 归 约 操作 

int sum = Stream.of(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) 


.reduce(0, Integer::sum); 
System.out.println(sum); 


可 以 看 到 ， 无 须 使 用 Intstrean 就 能 得 到 相同 的 结果 。Integer 类 还 定义 了 max 和 min 方 
法 ， 它 们 也 是 二 元 运算 符 ， 用 法 与 sun 方法 类 似 ， 如 例 3-22 所 示 。 
例 3-22 利用 reduce 方法 查找 最 大 值 

Integer max = Stream.of(3, 1, 4, 1, 5, 9) 


.reduce(Integer .MIN_VALUE, Integer::max); © 
System.out.println("The max vaLue is " + max); 


@ nax 的 标识 值 为 最 小 的 整数 


另 一 个 有 趣 的 例子 是 String 类 定义 的 concat 方法 ， 它 仅 传 入 一 个 参数 ， 看 起 来 不 怎么 像 
二 元 运算 符 。 




















String concat(String str) 
concat 方法 可 以 用 于 reduce 方法 ， 如 例 3-23 所 示 。 
例 3-23 利用 reduce 方法 拼接 流 中 的 字符 串 


String s = Stream.of("this", "is", "a", "list") 
.reduce("", String::concat); 
System.out.println(s); 0 


@ 打 Eh thisisalist 
上 述 代码 之 所 以 能 执行 ， 是 因为 通过 类 名 (如 String::concat) 使 用 方法 引用 时 ， 第 一 个 


参数 将 作为 concat 的 目标 ， 而 第 二 个 参数 是 concat 的 参数 。 由 于 结果 返回 的 是 String， 
目标 、 参 数 与 返回 类 型 均 为 同一 类 型 ， 可 以 将 其 视 为 reduce 方法 的 二 元 运算 符 。 


concat 方法 能 大 大 缩减 代码 的 尺寸 ， 浏 览 API 时 请 谨 记 在 心 。 
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使 用 收集 器 


尽管 concat 方法 可 行 ， 但 效率 很 低 ， 因 为 字符 串 拼接 操作 会 频繁 创建 和 销毁 对 象 。 更 
好 的 方案 是 采用 带 有 Collector 的 collect 方法 。 


Stream 接 口 定义 了 collect 方 法 的 一 种 重 载 形 式 ， 它 传 入 三 个 和 参数， 分 别 是 用 于 
创建 集合 的 Supplier， 为 集合 添加 单个 元 素 的 BiConsumer 以 及 合并 两 个 集合 的 
BiConsumer 。 对 字符 串 而 言 ，StringBuilder 是 一 种 天 然 的 累加 器 。 相 应 的 collect 实 
现 如 例 3-24 所 示 。 


例 3-24 利用 StringBuilder 收集 字符 串 
String s = Stream.of("this", "is", "a", "list") 
.COLLect(() -> new StringBuilder(), 0 
(sb, str) -> sb.append(str), @ 
(sb1i, sb2) -> sb1.append(sb2)) ©@ 
.toString(); 


@ 结果 Supplier 

@@ 为 结果 添加 一 个 值 

@@ 合并 两 个 结果 

可 以 通过 方法 引用 简化 上 述 代码 ， 如 例 3-25 所 示 。 
例 3-25 利用 方法 引用 收集 字符 串 


String s = Stream.of("this", "is", "a", "list") 
.Collect(StringBuilder: :new， 
StringBuilder::append, 
StringBuilder::append) 
.toString(); 


不 过 ， 最 简单 的 方案 是 采用 Collectors 工具 类 定义 的 joining 方法 ， 如 例 3-26 所 示 。 
例 3-26 利用 CoLLectors. joining 连接 字符 串 


String s = Stream.of("this", "is", "a", "list") 
.collect(Collectors. joining()); 





joining 方法 的 重 载 形式 传 入 字符 囊 定 界 符 ， 其 简单 易 行 无 出 其 右 。 相 关 讨 论 请 参见 
范例 4.2。 








4. reduce 方 法 的 最 一 般 形 式 
reduce 方法 的 第 三 种 形式 如 下 : 
<U> U reduce(U identity, 


BiFunction<U,? super T,U> accumulator, 
BinaryOperator<U> combiner) 


这 种 形式 略 显 复杂 ， 通 常 可 以 采用 更 简单 的 手段 实现 相同 的 目标 。 我 们 以 一 个 示例 说 明 这 
种 形式 的 应 用 。 
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例 3-27 定义 了 一 个 Book 类 ， 它 只 有 一 个 ID (整数 ) 和 一 个 标题 (字符 串 ) 。 
例 3-27 简单 的 Book 类 


public class Book { 
private Integer id; 
private String title; 


// 构造 函数 、getter 和 setter、toString、equals、hashCode… 





假设 存在 一 个 图 书 列表 ， 我 们 希望 将 列表 中 的 图 书 添加 到 茶 个 Map。 其 中 键 为 ID， 值 为 图 
书本 身 。 


采用 Collectors.toMap 方法 解决 这 个 问题 更 容易 ， 相 关 讨 论 请 参见 范例 4.3。 
之 所 以 以 此 为 例 ， 是 因为 它 比较 简单 ， 有 助 于 读者 理解 相对 复杂 的 reduce 
方法 。 











例 3-28 显示 了 一 种 解决 方案 。 
例 3-28 将 Book 添加 到 Map 


HashMap<Integer, Book> bookMap = books.stream() 
.reduce(new HashMap<Integer, Book>(), ©@ 
(map, book) -> { @ 
map.put(book.getId(), book); 
return map; 


}, 
(map1，map2) -> { © 
map1.putALLCmap2); 
return mapl; 
1 
bookMap.forEach((k,v) -> System.out.println(k + ": " + Vv)); 





@ putALL 的 标识 值 
@ 利用 put 将 一 本 书 添加 到 Map 

@ 利用 putAll 合并 多 个 Map 

我 们 从 reduce 方法 的 最 后 一 个 参数 开始 分 析 ， 这 是 最 简单 的 。 


第 三 个 参数 是 combiner ， 它 必须 是 Binary0perator。 在 本 例 中 ,提供 的 lambda 表达 式 传 
入 两 个 映射 ， 它 将 第 二 个 映射 中 的 所 有 键 复制 到 第 一 个 映射 ， 再 返回 第 一 个 映射 。 如 果 
putAll 方法 能 返回 映射 ，lambda 表达 式 会 更 简单 ， 可 惜 事 实 并 非 如 此 。 仅 当 reduce 方法 
并 行 完成 时 ， 组 合 器 才 有 意义 ， 因 为 我 们 需要 将 范围 内 每 一 部 分 产生 的 映射 合并 在 一 起 。 


第 二 个 参数 是 一 个 函数 ， 用 于 将 一 本 书 添加 到 Map。 类 似 地 ， 如 果 Map 的 put 方法 在 新 条 
目 添加 完毕 后 能 返回 Map， 函 数 会 更 简单 。 


第 一 个 参数 是 combiner 函数 的 标识 值 。 在 本 例 中 ， 标 识 值 是 一 个 为 空 的 Map， 因 为 该 标识 
值 与 其 他 任何 Map 结合 后 返回 的 是 其 他 Map。 
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例 3-28 的 输出 如 下 : 

1: Book{id=1, title='Modern Java Recipes'} 

2: Book{id=2, title='Making Java Groovy'} 

3: Book{id=3, title='Gradle Recipes for Android'} 
归 约 操作 是 函数 式 编程 习惯 用 法 的 基础 。 在 不 少 常见 的 用 例 中 ，Strean 接口 都 提供 了 相应 
的 内 置 方法 ， 如 sum 或 coLLect(CoLLectors.jotining('，)。 本 范例 也 讨论 了 reduce 方法 的 
直接 应 用 ， 或 许 能 对 读者 编写 自 定 义 方法 有 所 局 发 。 
一 旦 掌握 Java 8 中 reduce 方法 的 用 法 ， 读 者 就 能 举一反三 ， 理 解 如 何在 其 他 语言 中 使 用 相 
同 的 操作 。 即 便 这 种 操作 被 冠 以 不 同 的 名 称 〈 如 Groovy 将 甚 称 为 inject，Scala 将 其 称 为 
foLd) ， 其 原理 并 无 差别 。 























另 见 
有 关 将 POJO 列表 转换 为 Map 的 简便 方案 请 参见 范例 43， 有 关 汇 总 统计 (summary 
statistics) 的 讨论 请 参见 范例 3.8， 有 关 收 集 器 的 讨论 请 参见 第 4 章 。 


3.4 利用 reduce 方 法 校 验 排序 


问题 

用 户 希 望 检查 排序 是 否 正确 。 

方案 

使 用 reduce 方法 检查 每 对 元 素 。 

讨论 

java.util.stream.Streanm 接口 定义 的 reduce 方法 传 入 Binary0perator 作为 参数 : 








Optional<T> reduce(BinaryOperator<T> accumulator) 


BinaryOperator 是 一 种 输入 类 型 和 输出 类 型 相同 的 Function。 根 据 范 例 3.3 的 讨论 ， 
BinaryOperator 的 第 一 个 元 素 通常 为 累加 器 ， 第 二 个 元 素 传 入 流 的 每 个 值 ， 如 例 3-29 所 示 。 
例 3-29 利用 reduce 方法 对 BigDecimal 求 和 
BigDecimal total = Stream.iterate(BigDecimal.ONE, n -> Nn.add(BigDecimal .ONE)) 
.limit(10) 
.reduce(BigDecimal.ZERO, (acc, val) -> acc.add(val)); © 
System.out.println("The total is " + total); 


@ 使 用 BigDecimal 类 定义 的 add 方法 作为 BinaryOperator 


与 之 前 一 样 ，lambda 表达 式 返 回 的 任何 值 都 将 作为 下 一 次 迭代 时 变量 acc 的 值 。 在 本 例 
中 ， 程 序 计 算 前 10 个 BigDecimal 实例 的 值 。 
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这 是 reduce 方法 最 典型 的 应 用 方式 。 虽 然 acc 在 本 例 中 用 作 累 加 器 ， 但 并 不 意味 着 它 必 须 
作为 累加 器 使 用 。 接 下 来 ， 我 们 采用 范例 4.1 讨论 的 方法 来 排序 字符 串 。 例 3-30 展示 的 代 
码 段 根据 字符 串 的 长 度 对 它们 进行 排序 。 


例 3-30 根据 长 度 对 字符 串 排序 


List<String> strings = Arrays.asList( 
"this", 的 人 "a", "list", "of", "strings"); 














List<String> sorted = strings.stream() 
.Sorted(Comparator .comparingInt(String::length)) 
.collect(toList()); 0 


0 结果 为 Pas "is", "of "this", vtst "strings"] 
那么 ， 如 何 验证 排序 是 否 正确 呢 ? 答案 是 比较 每 对 相 邻 的 字符 串 ， 确 保 第 一 个 字符 串 的 长 
度 不 大 于 第 二 个 字符 串 。reduce 方法 就 能 实现 这 个 功能 ， 如 例 3-31 所 示 (Junit 测试 用 例 
的 一 部 分 )。 
例 3-31 测试 字符 串 排序 是 否 正 确 
strings.stream() 
.reduce((prev, curr) -> { 
assertTrue(prev.Length() <= curr.Length()); © 


return curr; © 


}); 
@ 检查 每 对 字符 串 的 排序 是 否 正确 
@ curr 成 为 prev 的 下 一 个 值 


对 于 每 对 连续 的 字符 串 ， 程 序 将 前 一 个 参数 和 当前 参数 分 别 赋 给 变量 prev 和 curr。 
assertTrue 用 于 测试 前 一 个 字符 串 的 长 度 是 否 小 于 或 等 于 当前 字符 串 的 长 度 。 需 要 注意 的 
是 ，reduce 方法 的 参数 将 返回 当前 字符 串 curr 的 值 ， 它 在 下 一 次 迭代 时 成 为 prev 的 值 。 


为 使 上 述 代 码 能 正确 执行 ， 唯 一 的 要 求 是 采用 顺序 (sequential) 流 或 有 序 流 。 















































另 见 

有 关 reduce 方法 的 讨论 请 参见 范例 3.3， 有 关 排 序 的 讨论 请 参见 范例 4.1。 
让 六 as 入 /Amd Wl 

3.5 ”利用 peek 方 法 对 流 进行 调试 

问题 

用 户 希 望 在 处 理 流 时 查看 流 中 的 各 个 元 素 。 

方案 


根据 需要 ， 在 流 的 流水 线 中 调用 java.util.stream.Strean 接口 定义 的 中 间 操 作 peek。 
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讨论 
流 处 理由 一 系列 零 个 或 多 个 中 间 操 作 构 成 ， 后 跟 终止 操作 。 每 个 中 间 操 作 都 返回 一 个 新 的 
流 ， 而 终止 操作 将 返回 不 是 流 的 值 。 


对 于 流 的 流水 线 所 涉及 的 中 间 操 作 序列 ， 初 次 接触 Java 8 的 用 户 有 时 候 会 感到 困惑 ， 因 为 
无 法 在 处 理 流 时 查看 各 个 元 素 的 值 。 
我 们 考虑 这 样 一 个 简单 的 方法 ， 即 接受 某 个 整数 流 的 开始 范围 和 结束 范围 ， 并 将 每 个 数字 
倍增 ， 然 后 仅 对 能 被 3 整除 的 结果 值 求 和 ， 如 例 3-32 所 示 。 
例 3-32 对 整数 进行 倍增 、 筛 选 与 求 和 
public int sumDoublesDivisibleBy3(int start, int end) { 
return IntStream.rangeClosed(start, end) 


.map(n -> nx 2) 
.filter(n -> n % 3 == 0) 
























































.Sum(); 
} 
编写 一 个 简单 的 测试 ， 验 证 程序 可 以 正确 执行 : 
@Test 


public void sumDoublesDivisibleBy3() throws Exception { 
assertEquals(1554, demo.sumDoublesDivisibleBy3(100, 120)); 
} 


上 述 测试 虽然 有 一 定 帮助 ， 但 并 未 提供 太 多 有 价值 的 信息 。 如 有 果 代 码 无 法 运行 ， 很 难 找 出 
症结 所 在 。 


如 例 3-33 所 示 ， 我 们 为 流水 线 添加 一 个 map 操作 ， 传 入 并 打印 每 个 值 ， 然 后 再 次 返回 这 
些 值 。 


例 3-33 ”添加 标识 映射 以 便 打 印 
public int sumDoublesDivisibleBy3(int start, int end) { 
return IntStream.rangeClosed(start, end) 
.map(n -> {©O 
System.out.println(n); 
return n; 









































}) 

.map(n -> n * 2) 
.filter(n -> n % 3 == 0) 
.Sum(); 


} 
@ 标识 映射 (identity map) 打印 并 返回 每 个 元 素 


程序 将 打印 从 start ( 含 ) 到 end ( 含 ) 的 数字 ， 每 行 一 个 数字 。 尽 管 不 应 在 生产 环境 中 使 
用 上 述 代码 ， 但 它 的 确 能 让 用 户 在 不 影响 流 处 理 的 同时 观察 其 内 部 操作 。 
这 正 是 Streanm 接口 中 peek 方法 的 工作 原理 ， 该 方法 的 声明 如 下 : 

Stream<T> peek(Consumer<? super T> action) 


根据 Javadoc 的 描述 ，peek 方法 “返回 一 个 由 流 的 元 素 构成 的 流 ， 当 元 素 从 所 生成 的 流 中 

















大 
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消耗 时 ， 对 每 个 元 素 执行 给 定 的 操作 ”。 由 于 Consumer 仅 传 入 一 个 输入 而 不 返回 任何 值 ， 
所 提供 的 Consumer 不 会 对 值 造 成 破坏 。 


peek 方法 是 一 种 中 间 操 作 ， 可 以 根据 需要 多 次 添加 ， 如 例 3-34 所 示 。 
例 3-34 使 用 多 个 peek 方法 


public int sumDoublesDivisibleBy3(int start, int end) { 
return IntStream.rangeClosed(start, end) 
.peek(n -> System.out.printf("original: %d%n", n)) © 














.map(n 


->n * 2) 


.peek(n -> System.out.printf("doubled : %d%n", Nn)) @ 
.filter(n -> n % 3 == 0) 
.peek(n -> System.out.printf("filtered: %d%n", n)) © 


.Sum(); 


} 
@ 在 倍增 前 打印 值 


@ 在 倍增 后 、 筛 选 前 打印 值 
@ 在 饰 选 后 、 求 和 前 打印 值 
程序 将 显示 每 个 元 素 的 初始 值 、 倍 增值 以 及 筛选 后 的 值 ， 输 出 结果 如 下 : 


original: 100 
doubled : 200 
original: 101 
doubled : 202 
original: 102 
doubled : 204 
filtered: 204 


original: 119 
doubled : 238 
original: 120 
doubled : 240 
filtered: 240 
































略 显 不 便 的 是 ， 很 难 





将 用 于 测试 的 peek 方法 设置 为 可 选 。 因 此 ， 尽 管 peek 方法 有 助 于 调 











试 ， 但 不 应 将 其 置 于 生产 环境 中 。 


3.6 字符 串 与 流 之 间 的 转换 


问题 





流 之 间 的 转换 。 


方案 





用 户 希望 通过 惯用 的 流 处 理 技术 (而 不 是 对 String 中 的 各 个 字符 进行 循环 ) 实现 字符 串 与 


使 用 java.Lang.CharSequence 接口 定义 的 默认 方法 chars 和 codePoints， 将 String 转换 
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为 IntsStream。 为 了 将 Intstream 转 换 回 String， 使 用 java.util.stream.IntStrean 接 
口 定义 的 collect 方法 的 重 载 形式 。 它 传 入 三 个 参数 ,分 别 是 Supplier、 表 示 累 加 器 的 
BiConsumer 以 及 表示 组 合 器 的 BiConsumer。 


讨论 
字符 串 是 若干 字符 的 集合 。 理 论 上 说 ， 将 字符 串 转 换 为 流 并 不 困难 ， 如 同 将 字符 串 转换 为 
集合 或 数组 一 样 。 遗 憾 的 是 ，String 不 属于 集合 框架 (collections framework) ， 因 此 无 法 
实现 Iterable， 不 存在 一 种 能 将 String 转换 为 Stream 的 strean 工厂 方法 。 另 一 种 方案 是 
采用 java.util.Array 类 定义 的 各 种 静态 strean 方法。 然而， 尽管 Arrays.strean 提供 了 
用 于 处 理 int[]、long[]、double[] 其 至 T[] 的 方法 ， 却 并 未 定义 用 于 处 理 char[] 的 方法 。 
API 的 设计 者 似乎 不 希望 用 户 采 用 流 技术 处 理 字 符 串 。 


尽管 如 此 ， 仍然 有 办 法 实现 字符 串 与 流 之 间 的 转换 。String 类 实现 CharSequence 接口 ， 它 
引入 了 两 种 能 生成 IntStrean 的 方法 (chars 和 codePoints) ， 它 们 都 是 接口 中 的 默认 方法 ， 
因此 存在 可 用 的 实现 。 例 3-35 展示 了 两 种 方法 的 签名 。 


例 3-35 CharSequence 接口 定义 的 chars 和 codePoints 方法 
default IntStream chars() 
default IntStream codePoints() 


chars 和 codePoiints 方法 的 不 同 之 处 在 于 ，chars 方法 用 于 处 理 UTF-16 编码 字符 ， 而 
codePoints 方法 用 于 处 理 完整 的 Unicode 代码 点 (code point) 集 。 如 果 读 者 对 两 种 方 
法 之 间 的 差异 感 兴趣 ， 可 以 阅读 Javadoc 中 有 关 java.Lang.Character 类 的 描述 。 就 本 
范例 而 言 ， 区 别 只 在 于 返回 的 整数 类 型 : chars 方法 返回 一 个 由 序列 中 的 char 值 构成 的 
IntStream， 而 codePoints 方法 返回 一 个 由 Unicode 代码 点 构成 的 IntStream。 


那么 ， 如 何 将 字符 流转 换 回 字符 串 呢 ? Stream.collect 方 法 对 流 元 素 执 行 可 变 归 
约 (mutable reduction) 操作 以 生成 集合 。Collectors 工具 类 提供 了 大 量 可 以 生成 所 需 
Collector 的 静态 方法 (如 本 书 讨论 的 toList、toSet、toMap、joining 以 及 其 他 许多 方 
法 )， 因 此 传 入 Collector 的 collect 方法 在 开发 中 最 为 常用 。 


然而 ， 明 显 看 出 缺少 的 是 Cottector 传 入 一 个 字符 流 并 将 其 组 装 为 字符 串 。 好 在 代码 并 不 
复杂 ， 可 以 使 用 coLtLect 的 另 一 种 重 载 形式 ， 它 传 入 一 个 Supplier 以 及 两 个 分 别 作 为 累加 
器 和 组 合 器 的 BtConsumer 参数 。 


听 起 来 似乎 比 实际 情况 要 复杂 得 多 。 接 下 来 ， 我 们 编写 isPalindrone 方法 ， 以 检查 某 个 字 
符 串 是 否 属于 回 文 (palindrome)。 回 文 检 查 器 不 区 分 大 小 写 ， 它 首先 删除 结果 字符 串 中 存 
在 的 标点 符号 ， 再 检查 字符 串 是 否 正 读 和 反 读 都 一 样 。 用 于 测试 字符 串 的 isPaLindrome 方 
法 如 例 3-36 所 示 ， 这 是 Java 7 及 之 前 版 本 的 实现 。 


例 3-36 检查 字符 串 是 否 属于 回 文 (Java7 及 之 前 ) 
public boolean isPalindrome(String s) { 
StringBuilder sb = new StringBuilder(); 
for (char c : s.toCharArray()) { 
if (Character.isLetterOrDigit(c)) { 
sb.append(c); 
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} 
} 
String forward = sb.toString().toLowerCase(); 
String backward = sb.reverse().toString().toLowerCase(); 
return forward.equals(backward); 


} 


以 上 代码 具有 典型 的 非 函 数 式 编程 风格 。isPalindrome 方法 首先 声明 一 个 具有 可 变 状 态 的 
单独 对 象 (StringBuilder 实例 )， 然 后 对 集合 进行 从 代 (由 String 类 定义 的 toCharArray 
方法 返回 的 char[])， 并 利用 if 条 件 语 句 决 定 是 否 将 值 附加 到 缓冲 区 。StringBuilder 类 
还 定义 了 一 个 能 更 容易 实现 回 文 检查 的 reverse 方法 ，String 类 则 没有 类 似 的 方法 。 这 种 
可 变 状态 、 迭 代 、 决 策 语 句 的 组 合 迫 切 需 要 一 种 林 于 流 的 替代 方案 ， 如 例 3-37 所 示 ， 这 是 
Java 8 的 实现 。 


例 3-37 检查 字符 串 是 否 属于 回 文 (Java 8) 
public boolean isPalindrome(String s) { 

String forward = s.toLowerCase().codePoints() © 
.filter(Character::isLetterOrDigit) 
.Collect(StringBuilder: :new， 

StringBuilder::appendCodePoint, 
StringBuilder: :append) 
.toString(); 

















String backward = new StringBuilder(forward).reverse().toString(); 
return forward.equals(backward); 


@ 返回 IntStream 


在 本 例 中 ，codePoiints 方法 返回 IntStream， 之 后 可 以 使 用 与 例 3-37 相同 的 条 件 进 行 科 选 
意思 的 是 collect 方法 ， 其 签名 为 : 


<R> R collect(Supplier<R> supplier, 
BiConsumer<R,? suyper T> accumulator, 
BiConsumer<R,R> combiner) 


这 三 个 参数 的 用 途 如 下 。 


。 Supplier 生成 经 过 归 约 的 对 象 (本 例 为 StringBuilder)。 

。 第 一 个 Biconsumer 将 流 的 各 个 元 素 累 加 至 所 生成 的 数据 结构 ， 本 例 使 用 appendCodePoint 
方法 。 

。 第 二 个 BtConsumer 表示 组 合 器 ， 它 是 一 个 “无 干扰 的 无 状态 函数 ”(non-interfering, 
stateless nee), 用 于 将 两 个 必须 与 累加 器 兼容 的 值 组 合 在 一 起 (本 例 为 append 方法 )。 
注意 ， 组 合 器 仅 在 并 行 操 作 时 使 用 。 


collect 方法 的 参数 略 多 ， 不 过 其 优点 在 于 代码 不 必 区 分 字符 和 整数 ， 而 这 是 处 理 字符 串 
元 素 时 经 常 遇 到 的 问题 。 


例 3-38 显示 了 针对 回 文 检查 器 的 简单 测试 。 
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例 3-38 测试 回 文 检查 器 


private PalindromeEvaluator demo = new PalindromeEvaluator(); 


QTest 
public void ispalindrome() throws Exception { 
assertTrue( 
Stream.of("Madam，in Eden, I'm Adam", 
"Go hang a salami; I'm a Lasagna hog "， 
"Flee to me, remote elf!", 
"A Santa pets rats as Pat taps a star step at NASA") 
.allMatch(demo: :isPpalindrome)); 


assertFalse(demo.isPpalindrome("This is NOT a palindrome")); 


} 


将 字符 串 视 为 一 种 字符 数组 不 太 符 合 Java 8 倡导 的 函数 式 习 惯用 法 ， 但 希望 本 范例 讨论 的 
机 制 能 对 读者 有 所 启发 。 








另 见 
有 关 收 集 器 的 讨论 请 参见 第 4 章 ， 有 关 实 现 自 定义 收集 器 的 讨论 请 参见 范例 4.9， 有 关 
allMatch 方法 的 讨论 请 参见 范例 3.10。 


3.7 ”获取 元 素数 量 


问题 

用 户 希 望 获取 流 中 元 素 的 数量 。 

方案 

使 用 java.util.stream.Streanm 接口 定义 的 count 方法， 或 java.util.stream.Collectors 
类 定义 的 counting 方法 。 


讨论 
本 范例 相当 简单 ， 目 的 是 为 范例 4.6 讨论 的 下 游 收集 器 作 铺 热 。 

如 例 3-39 所 示 ，Strean 接口 定义 了 count 默认 方法 ， 它 能 返回 Long 型 数据 。 
例 3-39 利用 Stream.count 方法 获取 元 素数 量 


Long count = Stream.of(3，1，4，1，5，9，2，6，5).count(); 
System.out.printf("There are %d elements in the stream%n", count); © 











@ 打印 There are 9 elements in the stream 


count 方法 的 有 趣 之 处 在 于 它 的 实现 方式 。 根 据 Javadoc 的 描述 ,“ 这 是 一 种 特殊 的 归 约 操 
作 ， 相 当 于 ”: 
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return mapToLong(e -> 1L).sum(); 


首先 ， 流 的 每 个 元 素 都 被 映射 为 1 (Long)。 然 后 ，mapToLong 方法 生成 LongStream， 它 定 
义 了 sum 方 法。 换言之 ， 先 将 所 有 元 素 映 射 为 1， 再 将 它们 相 加 ， 简 单 明 了 。 


此 外 ，Collectors 类 定义 了 一 种 类 似 的 方法 counting， 如 例 3-40 所 示 。 


例 3-40 利用 Collectors.counting 方法 获取 元 素数 量 
count = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.collect(Collectors.counting()); 
System.out.printf("There are %d elements in the stream%n", count); 


这 两 种 方法 得 到 的 结果 并 无 不 同 ， 但 既然 已 有 Stream.count， 为 什么 还 要 讨论 Collectors. 
counting 呢 ? 
我 们 当然 可 以 使 用 Stream.count 方法 ， 按 说 也 应 该 这 样 处 理 。 不 过 “下 游 收集 器 ” 
(downstream collector) 的 使 用 将 在 范例 4.6 进行 详细 讨论 。 就 目前 而 言 ， 我 们 考虑 例 3-41。 
例 3-41 对 根据 长 度 划 分 的 字符 串 计数 
Map<Boolean, Long> numberLengthMap = strings.stream() 
.collect(Collectors.partitioningBy( 


s -> s.length() % 2 == 0, © 
Collectors.counting())); ©@ 





























numberLengthMap.forEach((k,v) -> System.out.printf("%5s: %d%n", k, v)); 


// 
// false: 4 
// true: 8 


@ 谓词 
@ 下 游 收集 器 


partitioningBy 方法 的 第 一 个 参数 是 Predicate， 其 作用 是 将 字符 串 分 为 满足 谓词 和 不 
满足 谓词 的 两 类 。 如 果 partitioningBy 方 法 只 有 这 一 个 参数 ， 则 结果 为 Map<Boolean， 
List<String>>， 其 中 键 为 true 和 false,， 值 为 偶数 长 度 和 奇数 长 度 字符 串 的 列表 。 


本 例 采 用 partitioningBy 方法 的 双 参 数 重 载 形式 ， 它 传人 Predicate 和 Collector。Collector 
被 称 为 下 游 收 集 器 ， 用 于 对 返回 的 每 个 字符 串 列表 进行 后 期 处 理 。 这 就 是 Collectors. 
counting 方法 的 用 例 。 双 参数 形式 的 partitioningBy 方法 将 输出 Map<Boolean，Long>， 其 值 
为 流 中 偶数 长 度 和 奇数 长 度 字 符 串 的 数量 。 
Streanm 接口 定义 的 其 他 几 种 方法 在 Collectors 类 中 也 有 对 应 的 方法 ， 其 他 章节 将 对 它们 进 
行 讨论 。 简 而 言 之 ， 直 接 处 理 流 时 请 使 用 Stream 定义 的 方法 ， 而 Collectors 定义 的 方法 
适用 于 partitioningBy 或 groupingBy 操作 的 下 游 后 期 处 理 。 

























































































另 见 
有 关 下 游 收集 器 的 讨论 请 参见 范例 4.6， 收 集 器 的 一 般 性 介绍 请 参见 第 4 章 ， 有 关 归 约 操 
作 的 讨论 请 参见 范例 3.3。 
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3.8 汇总 统计 

问题 

用 户 希 望 获取 数值 流 中 元 素 的 数量 、 总 和 、 最 小 值 、 最 大 值 以 及 平均 值 。 
方案 


使 用 IntStream、DoubleStrean 或 LongStrean 接口 定义 的 summaryStatistics 方法 。 


讨论 
基本 类 型 流 IntStream、DoubleStrean 与 LongStreanm 为 Stream 接口 引入 了 用 于 处 理 基 本 数 
据 类 型 的 方法 ，summaryStatistics 就 是 其 中 一 种 方法 ， 如 例 3-42 所 示 。 


例 3-42 summaryStatistics 方法 
DoubleSummaryStatistics stats = DoubLeStream.generate(Math: :random) 
.Limit(1 000_000) 
.SummaryStatistics(); 




















System.out.println(stats); ©@ 


stats .getCount()); 
stats.getMin()); 
stats.getMax()); 
stats.getSum()); 
stats .getAverage()); 


System.out.println("count: 
System.out.println("min : 
System.out.println("max 
System.out.println("sum 
System.out.println("ave 


@ 使 用 tostring 方法 打印 


+ + + + + 


从 Java7 开始 ， 可 以 在 数字 字面 量 中 使 用 下 划 线 ， 如 1_000_000。 


执行 上 述 程序 ， 输 出 结果 类 似 于 : 


DoubleSummaryStatistics{count=1000000,sum=499608.317465, min=0.000001，, 
average=0.499608, max=0.999999} 

count: 1000000 

min : 1.3938598313334438E-6 

max : 0.9999988915490642 

sum : 499608.31746475823 

ave : 0.49960831746475826 


DoubleSummaryStatistics 类 定义 的 tostring 方法 返回 字符 串 的 表达 形式 ， 也 提供 用 于 统计 
元 素数 量 、 总 和 、 最 小 值 、 最 大 值 以 及 平均 值 的 getter 方法 (getCount、getSum、getMax、 
getMin 以 及 getAverage)。 当 double 型 元 素 的 数量 达到 100 万 时 ， 最 小 值 趋 近 于 0， 最 大 
值 趋 近 于 1， 总 和 约 为 50 万 ， 平 均值 约 为 0.5。 























DoubLeSummaryStatistics 类 还 定义 了 以 下 两 个 有 趣 的 方法 : 


void accept(double value) 
void combine(DoubleSummaryStatistics other) 


accept 方法 用 于 在 汇总 信息 中 记录 另 一 个 值 ， 而 combine 


对 象 合 二 为 一 。 两 种 方法 在 计算 结果 之 前 ， 向 类 的 实例 添加 数据 时 使 用 。 


我 们 以 运动 员 薪资 跟踪 网 站 Spotrac 为 例 进行 讨论 。 本 和 


方法 将 两 个 DoubleSummaryStatistics 








的 源 代码 包括 一 个 文件 ， 它 记录 了 


2017 赛季 美国 职 棒 大 联盟 (MLB) 全 部 30 支 球 队 的 薪资 数据 ， 这 些 数据 均 来 自 Spotrac。 





例 3-43 定义 了 一 个 名 为 Tean 的 类 ， 包 括 id、name ( 队 
例 3-43 Teanm 类 包括 id、nanme 与 salary 


public class Team { 


名 ) 与 salary (薪资 ) 。 


private static final NumberFormat nf = NumberFormat.getCurrencyInstance(); 


private int id; 
private String name; 


private double salary; 
// 构造 函数 、getter 与 setter 


@Override 
public String toString() { 
return "Team{" + 
"id=" + id + 


,， Name='" + Name + '\'' + 
", salary=" + nf.format(salary) + 
rs 


} 
解析 球 队 工 资 文件 ， 结 果 如 下 : 


Team{id=1, name='Los Angeles Dodgers', salary=$245,269,535.00} 
Team{id=2, name='Boston Red Sox', salary=$202,135,939.00} 
Team{id=3, name='New York Yankees', salary=$202,095,552.00} 


Team{id=28, name='San Diego Padres', salary=$73,754,027.00} 
Team{id=29, name='Tampa Bay Rays', salary=$73,102,766.00} 
Team{id=30, name='Milwaukee Brewers', salary=$62,094,433.00} 





可 以 通过 两 种 方式 计算 球 队 集合 的 汇总 统计 信息 。 第 
形式 ， 如 例 3-44 所 示 。 


种 方式 采用 collect 方法 的 三 参数 


例 3-44 传 入 Supplier、 累 加 器 与 组 合 器 的 collect 方法 


DoubleSummaryStatistics teamStats = teams.stream() 


.mapToDouble(Team: :getSalary) 
.collect(DoubleSummaryStatistics: :new, 


DoubleSummaryStatistics::accept, 
DoubleSummaryStatistics::combine); 
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有 关 这 种 collect 方法 的 讨论 请 参见 范例 49。 在 本 例 中 ，coltect 方法 通过 构造 国 数 引 
用 来 提供 DoubleSummarystatistics 的 实例 ， 通 过 accept 方 法 将 男 一 个 值 添加 到 现 有 的 
DoubleSummaryStatistics 对 象 ， 以 及 通过 combine 方法 将 两 个 单独 的 DoubleSummaryStatistics 
对 象 合 二 为 一 。 

输出 结果 如 下 (为 便于 阅读 ， 对 结果 做 了 处 理 ) : 


30 teams 
sum = $4,232,271,100.00 











min = $62,094,433.00 
max = $245,269,535.00 
ave = $141,075,703.33 





计算 汇总 信息 的 另 一 种 方案 请 参见 范例 4.6 (下 游 收 集 器 )。 此 时 ， 汇 总 计算 如 例 3-45 所 示 。 
例 3-45 使 用 summarizingDouble 方法 进行 收集 


teamStats = teams.stream() 
.collect(Collectors.summarizingDouble(Team: :getSalary)); 
其 中 ，Collectors.summarizingDouble 方法 的 参数 是 各 队 的 薪资 。 无 论 采 用 哪 种 方案 ， 结 
果 并 无 区 别 。 


从 本 质 上 讲 ， 汇 总 统计 类 是 一 种 “ 精 糕 ”的 统计 方法 ， 因 为 它们 仅 能 统计 数量 、 最 大 值 、 
最 小 值 、 总 和 、 平 均值 等 属性 。 然 而 ， 如 果 只 需要 这 些 属性 ， 那 么 Java 标准 库 应 能 满足 



































汇总 统 人 种 特殊 形式 ， 其 他 归 约 操作 的 介绍 请 参见 范例 3.3， 有 关 下 游 收 
的 讨论 请 参见 范例 4.6， 有 关 多 参数 collect 方法 的 讨论 请 参见 范例 4.9。 


3.9 查找 流 的 第 一 个 元 素 
问题 
用 户 希 望 查找 满足 流 中 特定 条 件 的 第 一 个 元 素 。 


方案 


应 用 筛选 器 之 后 使 用 java.util.stream.Strean 接口 定义 的 findFirst 或 findAny 方法 。 


浪 
站 
ey 





讨论 
Streanm 接口 定义 的 findFirst 方法 返回 描述 流 中 第 一 个 元 素 的 Optional， 而 findAny 方法 





注 3: 当然 ， 读 者 从 本 范例 中 还 应 学 到 一 点 : 如 果 有 机 会 参加 MLB 比赛 ， 那 么 不 妨 一 试 ， 哪 怕 只 有 很 短 的 
上 场 时 间 。 赛 后 再 继续 学 习 Java 吧 ! 























邮 


返回 描述 流 中 某 个 元 素 的 0ptionaL。 两 种 方法 都 不 传人 参数 ， 意 味 着 映射 或 筛选 操作 已 经 
例如 ， 给 定 一 个 整数 列表 ， 为 查找 第 一 个 偶数 ， 可 以 在 应 用 偶数 筛选 器 后 使 用 findFirst 
方法 ， 如 例 3-46 所 示 。 


例 3-46 ”查找 第 一 个 偶数 
Optional<Integer> firstEven = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.filter(n -> n % 2 == 0) 
.findFirst(); 








System.out.printLn(firstEven); © 
@ 打印 Optional[4] 
如 果 流 为 空 ， 则 返回 值 是 一 个 空 Optional (如 例 3-47 所 示 ) 。 
例 3-47 流 为 空 时 使 用 findFirst 方法 


Optional<Integer> firstEvenGT10 = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.filter(n -> n > 10) 
.filter(n -> n % 2 == 0) 
.findFirst(); 


System.out.println(firstEvenGT10); © 
@ 打印 OptionaL.empty 


上 述 代 码 在 应 用 筛选 器 后 返回 第 一 个 元 素 ， 这 是 否 意 味 着 要 做 大 量 无 用 功 呢 ”为 什么 要 对 
所 有 元 素 进 行 取 模 运 算 ， 然 后 只 选择 第 一 个 元 素 呢 ?” 由 于 流 元 素 实 际 上 是 逐一 进行 处 理 
的 ， 这 不 是 一 个 问题 ， 相 关 讨 论 请 参见 范例 3.13。 


如 果 流 不 存在 出 现 顺序 (encounter order)， 它 可 能 返回 任何 元 素 。 不 过 在 本 例 中 ， 流 确实 具有 
出 现 顺序 ， 因 此 无 论 采 用 顺序 流 还 是 并 行 流 进 行 搜索 ,“ 第 一 个 ”偶数 始终 是 4。 详 见 例 3-48。 


例 3-48 在 并 行 流 中 使 用 firstEven 
firstEven = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.parallel() 
.filter(n -> n % 2 == 0) 
.findFirst(); 








System.out.printLn(firstEven); © 
@ 始终 打印 0ptional[4] 


初 看 之 下 有 些 奇怪 ， 为 什么 在 同时 处 理 多 个 数字 时 仍然 会 得 到 同一 个 值 呢 ?原因 在 于 出 现 
顺序 的 概念 。 
Java API 将 出 现 顺 序 定义 为 数据 源 使 其 元 素 可 用 的 顺序 。List 和 Array 都 有 出 现 顺序 ， 但 Set 
没有 。 

BaseStreanm 接口 (Strean 的 父 接口 ) 还 定义 了 一 种 名 为 unordered 的 方法 ， 它 可 能 返回 
(也 可 能 不 返回 ) 一 个 无 序 流 作为 中 间 操 作 。 
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set 与 出 现 顺序 


虽然 HashSet 实例 本 身 没有 出 现 顺序 ， 但 如 果 重 复 初始 化 包含 相同 数据 的 Hashset 实 
例 (Java 8)， 则 每 次 返回 的 元 素 顺 序 都 相同 ， 这 意味 着 每 次 调用 findFirst 方 法 也 会 
得 到 相同 的 结果 。 根 据 Javadoc 的 描述 ，findFirst Re 的 结 
果 ， 但 当前 的 实现 不 会 因为 流 是 无 序 的 而 改变 其 行 


如 果 和 希望 获得 一 个 具有 不 同 出 现 顺序 的 Set， 可 以 通过 添加 和 删除 足够 多 的 元 素来 强 
制 进 行 再 散 列 操作 (rehashing)。 例 如 : 


List<String> wordList = Arrays.asList( 
"this", "ons "a", "stream", "of", "strings"); 
Set<String> words = new HashSet<>(wordList); 


Set<String> words2 = new HashSet<>(words); 


// 接 下 来 ,添加 和 删除 足够 多 的 元 素来 强制 进行 再 散 列 操作 

IntStream.rangeClosed(0, 50).forEachOrdered(i -> 
words2.add(String.valueOf(i))); 

words2.retainAll(wordList); 






































// 这 些 集合 是 相等 的 ， 但 具有 不 同 的 元 素 排序 


System.out.printLn(words.equaLs(words2) ); 


System.out.printLn("Before: " + words); 

System.out.printLn("After : " + words2); 
输出 结果 类 似 于 : 

true 


Before: [a, strings, stream, of, this, is] 
After : [this, is, strings, stream, of, al] 


可 以 看 到 ， 两 次 排序 并 不 相同 ， 因 此 调用 findFirst 的 结果 也 将 有 所 不 同 。 


在 Java 9 中 ， 网 
始 化 ， 其 每 次 运行 的 选 代 顺序 也 会 发 生变 化 。 











findAny 方 法 要 么 返回 描述 流 中 某 个 元 素 的 0ptional， 要 么 在 流 为 空 时 返回 一 个 空 
Optional。 在 本 例 中 ， 操 作 的 行为 具有 显 式 不 确定 性 (explicit nondeterminism) ， 这 意味 着 
可 以 自由 选择 流 中 的 任何 元 素 ， 从 而 实现 对 并 行 操作 的 优化 。 


为 说 明 这 一 点 ， 考 虑 从 一 个 无 序 的 并 行 整 数 流 中 返回 任意 元 素 。 例 3-49 在 随机 延迟 100 这 
秒 后 将 每 个 元 素 映 射 到 其 自身 ， 从 而 引入 了 一 个 人 为 的 延迟 。 


例 3-49 随机 延迟 后 在 并 行 流 中 使 用 findAny 方法 
public Integer delay(Integer n) { 


try { 
Thread.sLeep((Long) (Math.random() * 100)); 
} catch (InterruptedException ignored) { © 





























注 4: 感谢 Stuart Marks 所 做 的 解释 。 





} 


return nN; 


} 
// 其 他 代码 





Optional<Integer> any = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.Unordered() 
.parallel() 
.map(this: :delay) 


8 
© 
© 
.findAny(); © 


System.out.println("Any: " + any); 
@ Java 中 唯一 可 以 捕获 和 忽略 的 异常 
@ 顺序 并 不 重要 
@ 在 并 行 流 中 采用 通用 fork/join 线程 池 
@ 引入 随机 延迟 
@ 无 论 出 现 顺序 如 何 ， 返 回 第 一 个 元 素 
上 述 代码 可 以 输出 任何 给 定 的 数字 ， 取 决 于 先 执行 到 哪个 线程 。 


findFirst 和 findAny 都 属于 短路 终止 操作 (short-circuiting, terminal operation) 。 当 作用 于 
无 限 流 上 时， 短路 操作 可 能 产生 一 个 有 限 流 。 如 果 终 止 操 作 在 作用 于 无 限 输入 时 也 可 能 在 有 
限时 间 内 终止 ， 它 就 属于 短路 操作 。 


从 这 一 节 讨 论 的 示例 可 以 看 到 ， 并 行 (parallelization) 在 某 些 情况 下 非但 不 会 提高 性 能 ， 
反而 会 降低 性 能 。 流 是 惰性 的 ， 它 们 只 处 理 满 足 流水 线 所 需 的 元 素 。 在 本 例 中 ， 由 于 只 要 
求 返回 第 一 个 元 素 ， 启动 fork/join 线程 地 显得 有 些 矫 枉 过 正 。 详 见 例 3-50。 


例 3-50 在 顺序 流 和 并 行 流 中 使 用 findAny 方法 
Optional<Integer> any = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.Unordered() 
.map(this: :delay) 
.findAny(); © 









































System.out.println("Sequential Any: " + any); 


any = Stream.of(3, 1, 4, 1, 5, 9, 2, 6, 5) 
.Unordered() 
.parallel() 
.map(this: :delay) 
.findAny(); @ 


System.out.println("Parallel Any: " + any); 


@ 顺序 流 (默认 ) 





注 5: 严格 来 说 ， 不 应 该 捕获 并 忽略 任何 异常 。 尽 管 忽略 InterruptedException 的 做 法 很 常见 ， 但 这 并 不 是 
个 好 主意 。 














流 式 操作 | 57 


@ 并 行 流 
典型 的 输出 如 下 所 示 (在 一 台 8 核 计算 机 上 运行 ， 默认 使 用 8 线程 fork/join 线程 池 )。 
对 于 顺序 处 i 


main // 顺序 处 理 ， 因 此 只 有 一 个 线程 
Sequential Any: Optional[3] 


对 于 并 行 处 理 ; 


ForkJoinPooL.commonPooL-worker- 
ForkJoinPooL.commonPooL-worker- 
ForkJoinPooL.commonPooL-worker- 
ForkJoinPooL.commonPooL-worker- 
ForkJoinPooL.commonPooL-worker- 
main 

ForkjJoinPool .commonPool-worker-2 
ForkJoinPool .commonPool-worker-4 
Parallel Any: Optional[1] 


顺序 流 只 需 访问 并 返回 一 个 元 素 ， 因 此 属于 短路 操作 。 并 行 流 启动 8 个 不 同 的 线程 ， 找 到 
一 个 元 素 后 关闭 所 有 线程 。 换 言 之 ， 并 行 流 访问 了 大 量 并 不 需要 的 值 。 


请 注意 ， 流 的 出 现 顺 序 是 一 个 重要 概念 。 如 果 流 具有 出 现 顺 序 ，findFirst 方法 总 是 会 返 
回 同一 个 值 。 而 findAny 方法 可 以 返回 任意 元 素 ， 因 此 更 适合 在 并 行 操作 中 使 用 。 


















































OW 



































号 
另 见 
有 关 情 性 流 的 讨论 请 参见 范例 3.13， 有 关 并 行 流 的 讨论 请 参见 第 9 章 。 


3.10 使 用 anyMatch、aLLMatch 与 noneMatch 方 法 





问题 
用 户 希 望 确定 流 中 是 否 有 元 素 匹 配 Predicate， 或 全 部 元 素 匹 配 Predicate， 或 没有 元 素 匹 
机 Predicate。 


方案 
使 用 java.util.stream.Strean 接口 定义 的 anyMatch、allMatch 与 noneMatch 方法 ， 每 种 方 
法 返回 一 个 布尔 值 。 


讨论 
anyMatch、aLLMatch 与 noneMatch 方法 的 签名 如 下 : 









































注 6: 这 里 假定 已 将 延迟 方法 修改 为 打印 当前 线程 的 名 称 及 其 正在 处 理 的 值 。 
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boolean anyMatch(Predicate<? super T> predicate) 
boolean allMatch(Predicate<? super T> predicate) 
boolean noneMatch(Predicate<? super T> predicate) 


每 种 方法 的 用 途 不 言 自 明 。 我 们 以 质数 计算 器 为 例 进行 说 明 。 在 大 于 或 等 于 2 的 自然 
数 中 ， 如 果 一 个 数 无 法 被 除 1 和 该 数 自 身 之 外 的 其 他 数 整除 ， 则 这 个 数 为 质数 (prime 
number) ， 否 则 为 合 数 (composite number) 。 


如 例 3-51 所 示 ， 为 验证 某 个 数 是 否 为 质数 ， 一 种 简单 的 做 法 是 对 从 2 开始 到 该 数 平方 根 的 
所 有 数 做 取 模 运算 ,然后 取 整 。 


例 3-51 质数 校 验 
public boolean isPrime(int num) { 
int limit = (int) (Math.sqrt(num) + 1); 
return num == 2 || num > 1 && IntStream.range(2, limit) 
.NoneMatch(divisor -> num % divisor == 0); @ 














} 
@ 校 验 上 限 
@ 使 用 noneMatch 方法 
借 由 noneMatch 方法 ， 质 数 校 验 易如反掌 。 





BigInteger 类 与 质数 
java.math.BigInteger 类 定义 的 isProbablePrime 方法 很 有 意思 ， 其 签名 为 : 
boolean isProbablePrime(int certainty) 
如 果 isProbablePrime 方法 返回 false， 则 值 显 然 为 合 数 ; 如 果 返 回 true，certainty 参 
数 就 派 上 用 场 了 。 


certainty 的 值 表 示 调 用 程序 可 以 容忍 的 不 确定 性 。 如 果 isProbablePrime 方法 返回 
true， 则 一 个 数 实际 为 质数 的 概率 将 超过 1 - 1/2^{certainty}。 因 此 ，certainty 等 于 2 
意味 着 概率 为 0.75，certainty 等 于 3 意味 着 概率 为 0.875，certainty 等 于 4 意味 着 概 
率 为 0.9375， 等 于 5 意味 着 概率 为 0.96875， 以 此 类 推 。 


certainty 参数 的 值 越 大 ，isProbablePrime 方法 的 执行 时 间 越 长 。 








例 3-52 显示 了 质数 校 验 的 两 种 方案 。 
例 3-52 针对 质数 计算 的 测试 


private Primes calculator = new Primes(); 


QTest © 
public void testIsPrimeUsingALLMatch() throws Exception { 
assertTrue(IntStream.of(2, 3, 5, 7, 11, 13, 17, 19) 
.allMatch(calculator: :isprinme)); 


} 


QTest @ 
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public void testIsprimeWithComposites() throws Exception { 
assertFalse(Stream.of(4, 6, 8, 9, 10, 12, 14, 15, 16, 18, 20) 
.anyMatch(calculator::isprime)); 


} 
@ 为 简单 起 见 ， 使 用 aLLMatch 方法 
@ 使 用 合 数 进行 测试 
第 一 个 测试 调用 已 知 质数 流 中 的 allMatch 方法 (参数 为 Predicate) ， 仅 当 所 有 值 均 为 质数 
时 返回 true。 


第 二 个 测试 对 一 个 合 数 集合 使 用 anyMatch 方法 ， 并 认定 集合 中 的 数字 均 不 满足 谓词 。 
anyMatch、allMatch 与 noneMatch 方法 能 方便 地 对 特定 条 件 下 的 值 流 进行 校 验 。 


不 过 ， 有 一 个 可 能 引起 问题 的 边缘 条 件 应 予 注意 。 如 例 3-53 所 示 ， 三 种 方法 在 作用 于 空 流 
(empty stream) 时 的 行为 不 那么 直观 。 
例 3-53 针对 空 流 的 测试 
@Test 
public void emptyStreamsDanger() throws Exception { 
assertTrue(Stream.empty().aLLMatch(e -> false)); 
assertTrue(Stream.empty().noneMatch(e -> true)); 
assertFalse(Stream.empty().anyMatch(e -> true)); 


} 


根据 Javadoc 的 描述 ， 对 于 allMatch 和 noneMatch 方法 ,“ 流 为 空 将 返回 true 且 不 再 评 
估 谓 词 ”， 因 此 两 种 方法 中 的 谓词 可 以 是 任何 值 。 而 对 于 anyMatch 方法 ， 流 为 空 将 返回 
false， 这 可 能 导致 错误 诊断 异常 困难 ， 所 以 应 用 时 务 须 谨慎 。 


如 果 流 为 空 ， 无 论 提供 的 谓词 是 什么 ，allMatch 和 noneMatch 方法 将 返回 
true， 而 anyMatch 方法 将 返回 false。 三 种 方法 在 流 为 空 时 都 不 会 评估 任何 
提供 的 谓词 。 





























另 见 

有 关 Predicate 接口 的 讨论 请 参见 范例 2.3。 

3.11 使 用 flatMap 与 nap 方 法 

问题 

用 户 希 望 以 某 种 方式 转换 流 中 的 元 素 ， 但 不 确定 该 使 用 nap 还 是 flathap 方法 。 
方案 


如 果 需 要 将 每 个 元 素 转换 为 一 个 值 ， 则 使 用 Stream.map 方法 ， 如 果 需 要 将 每 个 元 素 转换 为 
多 个 值 ， 且 需要 将 生成 的 流 “ 展 平 "， 则 使 用 Stream.flatMap 方法 。 
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讨论 
map 和 flatMap 方法 均 传 人 Function 作为 参数 。map 方法 的 签名 如 下 : 

<R> Stream<R> map(Function<? super T,? extends R> mapper) 
Function 传人 一 个 输入 ， 并 将 其 转换 为 一 个 输出 。map 方法 则 将 一 个 T 类 型 的 输入 转换 为 
一 个 R 类 型 的 输出 。 
我 们 创建 一 个 由 顾客 名 和 order 集合 构成 的 Customer 类 。 为 简单 起 见 ，Order 类 只 包含 一 
个 整数 ID。 例 3-54 展示 了 Customer 类 和 0rder 类 。 
例 3-54 一 对 多 关系 


public class Customer { 


private String name; 
private List<Order> orders = new ArrayList<>(); 














public Customer(String name) { 
this.name = name; 


} 


public String getName() { return name; } 
public List<Order> getOrders() { return orders; } 


public Customer addOrder(Order order) { 
orders.add(order); 
return this; 


} 


public class Order { 
private int id; 


public Order(int id) { 
this.id = id; 


} 


public int getId() { return id; } 
} 


接 下 来 ， 我 们 创建 者 干 新 顾客 并 添加 一 些 订 单 ， 如 例 3-55 所 示 。 
例 3-55 客户 与 订单 示例 


Customer sheridan = new Customer("Sheridan"); 
Customer ivanova = new Customer("Ivanova"); 
Customer garibaldi = new Customer("Garibaldi"); 


sheridan.addOrder(new Order(1)) 
.addOrder(new Order(2)) 
.addOrder(new Order(3)); 

ivanova.addOrder(new Order(4)) 
.addOrder(new Order(5)); 


List<Customer> customers = Arrays.asList(sheridan, ivanova, garibaldi); 
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当 输 入 参数 和 输出 类 型 之 间 存 在 一 一 对 应 的 关系 时 ， 将 执行 map 操作 。 可 以 将 顾客 映射 到 
他 们 的 姓名 并 打印 ， 如 例 3-56 所 示 。 
例 3-56 ”将 顾客 映射 到 他 们 的 姓名 

CuUstomers .stream() 0 


.map(Customer: :getName) 8 
.forEach(System.out::println); © 


@ Stream<Customer> 

@ Stream<String> 

@ 谢 里 登 、 伊 万 诺 娃 、 加 里 波 第 

如 果 将 顾客 映射 到 订单 而 不 是 他 们 的 姓名 ， 就 得 到 了 一 个 集合 的 集合 ， 如 例 3-57 所 示 。 
例 3-57 将 顾客 映射 到 订单 


CUustomers.stream() 
.map(Customer: :getOrders) 
.forEach(System.out::println); 








0 
2 


customers.stream() 
.map(customer -> customer.getOrders().stream()) © 
.forEach(System.out::println); 


@ Stream<List<Order>> 
@ [Order{id=1}, Order{id=2}, Order{id=3}], [Order{id=4}, Order{id=5}], [] 
加 Stream<Stream<Order>> 


map 操作 的 结果 为 Stream<List<0rder>>， 甚 最 后 一 个 列表 为 空 。 如 果 在 订单 列表 中 调用 
strean 方法 ， 则 结果 为 Stream<Stream<0rder>>， 其 最 后 一 个 内 部 流 (inner stream) 为 空 流 。 
flatMap 方法 的 作用 就 在 于 此 ， 其 签名 如 下 : 

<R> Stream<R> flatMap(Function<? super T,? extends Stream<? extends R>> mapper) 


对 于 每 个 泛 型 参数 T， 国 数 生成 的 是 Stream<R> 而 不 仅仅 是 R。 之 后 ，flatMap 方法 从 各 个 
流 中 删除 每 个 元 素 并 将 它们 添加 到 输出 ， 从 而 “ 展 平 ” 生 成 的 流 。 




















flatMap 方法 的 Function 参数 传 入 一 个 泛 型 输入 参数 ， 但 生成 的 输出 类 型 为 


Stream。 


flatMap 方法 的 应 用 如 例 3-58 所 示 。 
例 3-58 对 顾客 订单 应 用 fLatMap 方法 


Customers.stream() 0 
.flatMap(customer -> customer.getOrders().stream()) @ 
.forEach(System.out::println); 


@@ Stream<Customer> 





62 | 第 3 章 


@ Stream<Order> 

@ order{id=1}, Order{id=2}, Order{id=3}, Order{id=4}, Order{id=5} 

flatMap 操作 的 结果 为 Stream<order>。 由 于 它 已 被 “ 展 平 "， 无 须 再 担心 幅 套 流 (nested stream)。 
与 flatMap 方法 有 关 的 两 个 重要 概念 应 予 注意 : 


。 方法 参数 Function 产生 一 个 输出 值 流 ; 
。 生成 的 元 素 被 “ 展 平 ”为 一 个 新 的 流 。 


将 上 述 两 点 谨 记 在 心 ， 就 能 体会 到 fLatMap 方法 的 有 用 之 处 。 


最 后 需要 指出 的 是 ，Java 8 引入 的 Optional 类 同样 定义 了 map 和 flatMap 方法 ， 详 细 讨论 
请 参见 范例 6.4 和 范例 6.5。 





另 见 
有 关 0ptional.map 方法 的 讨论 请 参见 范例 6.5， 有 关 0ptional.flatMap 方法 的 讨论 请 参见 
范例 6.4。 


3.12 流 的 拼接 

问题 

用 户 希 望 将 两 个 或 多 个 流 合并 为 一 个 流 。 
方案 


Stream.concat 方法 用 于 合并 两 个 流 。 如 果 需 要 合并 多 个 流 ， 请 使 用 Stream.flatMap 方法 。 





讨论 
假设 我 们 从 多 个 信 源 获取 到 数据 ， 且 希望 使 用 流 来 处 理 其 中 的 每 个 元 素 。 一 种 方案 是 采用 
Strean 接口 定义 的 concat 方法 ， 其 签名 如 下 : 


static <T> Stream<T> concat(Stream<? extends T> a, Stream<? extends T> b) 


concat 方法 将 创建 一 个 情 性 的 拼接 流 (lazily concatenated stream)， 其 元 素 是 第 一 个 流 的 所 
有 元 素 ， 后 跟 第 二 个 流 的 所 有 元 素 。 根 据 Javadoc 的 描述 ， 如 果 两 个 输入 流 均 为 有 序 流 ， 
则 生成 的 流 也 是 有 序 流 ， 如 果 某 个 输入 流 为 并 行 流 ， 则 生成 的 流 也 是 并 行 流 。 关 闭 生成 的 
流 也 会 关闭 两 个 输入 流 。 




















两 个 输入 流 所 包含 的 元 素 类 型 必须 相同 。 
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例 3-59 显示 了 拼接 两 个 流 的 简单 示例 。 
例 3-59 拼接 两 个 流 





@Test 

public void concat() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 
Stream<String> second = Streanm. of("X", YD) 


List<String> strings = Stream.concat(first, second) © 
.Collect(Collectors. toList()); 


List<String> stringList = Arrays.asList("a", "b", "c"”, "X", "Y", "27"); 


assertEquals(stringList, strings); 


} 
@ 将 第 二 个 流 的 元 素 附加 到 第 一 个 流 的 元 素 之 后 
如 果 需 要 添加 第 三 个 流 ， 可 以 和 姐 套 使 用 拼接 操作 ， 如 例 3-60 所 示 。 
例 3-60 拼接 多 个 流 (concat 方法 ) 


@Test 
public void concatThree() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 


Stream<String> second = Stream.of ("Xx", 人 
Stream<String> third = Stream.of("alpha", "beta", "gamma"); 


List<String> strings = Stream.concat(Stream.concat(first, second), third) 


.Collect(Collectors. toList()); 
List<String> St tng ist = Arrays.asList("a", "b", "c", 
"X", WY 2 'alpha" "beta", "gamma" ); 
assertEquals(stringList, strings); 


ow 


尽管 嵌 套 拼接 的 方案 可 行 ， 但 请 注意 Javadoc 所 做 的 注释 : 


通过 重复 拼接 操作 构建 流 时 应 谨慎 行 事 。 访 问 一 个 深度 拼接 流 中 的 元 素 可 能 





深层 调用 链 (deep call chain) 其 至 抛 出 StackOverflowException。 


换言之 ，concat 方法 实际 上 构建 了 一 个 流 的 二 又 树 (binary tree) ， 使 用 过 多 就 会 
处 理 。 


一 种 方案 是 采用 reduce 方法 执行 多 次 拼接 操作 ， 如 例 3-61 所 示 。 
例 3-61 拼接 多 个 流 (reduce 方 法) 











@Test 
public void reduce() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 


Stream<String> second = Stream. of ("X", TV 
Stream<String> third = Stream.of("alpha", "beta", "gamma"); 
Stream<String> fourth = Stream.empty(); 


List<String> strings = Stream.of(first, second, third, fourth) 
.reduce(Stream.empty(), Stream::concat) © 
.Collect(Collectors. toList()); 


List<String> stringList = Arrays.asList("a", "b", "c", 
"X", 由 人 WA "alpha" "beta", nai) 


导致 














以 





assertEquals(stringList, strings); 


} 
@ 对 空 流 使 用 reduce 方法 和 二 元 运算 符 


由 于 用 作 方 法 引用 的 concat 方法 属于 二 元 运算 符 ， 上 述 程序 同样 有 效 。 不 过 请 注意 ， 虽 然 














代码 更 简洁 ， 但 并 不 能 解决 潜在 的 栈 洪 出 (stack overflow) 问题 





有 鉴于 此 ， 在 合并 多 个 流 时 ， 使 用 flatMap 方法 成 为 一 种 自然 而 然 的 解决 方案 





所 示 。 
例 3-62 拼接 多 个 流 (flatMap 方法 ) 


QTest 

public void flatMap() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 
Stream<String> second = Streanm. of ("X", 2 
Stream<String> third = Stream.of("alpha", "beta", "gamma"); 
Stream<String> fourth = Stream.empty(); 


List<String> strings = Stream.of(first, second, third, fourth) 
.flatMap(Function.identity()) 
.collect(Collectors. toList()); 
List<String> stringList = Arrays.asList("a", "b", "c", 
"X", "Y", "Z", "alpha", "beta", "gamma"); 
assertEquals(stringList, strings); 


} 

















上 述 代码 可 以 运行 ,但 仍然 有 其 不 足 。 如 果 任 何 一 个 输入 流 为 并 行 流 ， 那 么 通 
法 创建 的 流 也 是 并 行 流 ， 但 flatMap 方法 返回 的 则 不 是 并 行 流 ( 例 3-63)。 





例 3-63 并 行 流 还 是 非 并 行 流 


QTest 

public void concatParaLLeL() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 
Stream<String> second = Streanm. of("X", "Y", "2"); 


Stream<String> third = Stream.of("alpha", "beta", "gamma"); 


， 如 例 3-62 


过 concat 方 


Stream<String> total = Stream.concat(Stream.concat(first, second), third); 


assertTrue(total.isparallel()); 


} 

QTest 

public void fLatMapNotParaLLeL() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 
Stream<String> second = Streanm. of("X", MY 
Stream<String> third = Stream.of("alpha", "beta", "gamma"); 
Stream<String> fourth = Stream.empty(); 
Stream<String> total = Stream.of(first, second, third, fourth) 

.flatMap(Function.identity()); 

assertFalse(total.isparallel()); 

} 
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尽管 如 此 ， 只 要 尚未 开始 处 理 数据 ， 总 是 可 以 通过 调用 parallel 方 法 来 实现 并 行 流 
( 例 3-64)。 


例 3-64 将 flLatMap 方法 返回 的 流转 换 为 并 行 流 
QTest 
public void fLatMapParaLLeL() throws Exception { 
Stream<String> first = Stream.of("a", "b", "c").parallel(); 
Stream<String> second = Stream.of("X", "Y", "27"); 
Stream<String> third = Stream.of("alpha", "beta", "gamma"); 
Stream<String> fourth = Stream.empty(); 





Stream<String> total = Stream.of(first, second, third, fourth) 
.flatMap(Function.identity()); 
assertFalse(total.isPparallel()); 


total = total.parallel(); 
assertTrue(total.isparallel()); 


} 
如 上 所 示 ， 由 于 flatMap 属于 中 间 操 作 ， 可 以 通过 parallel 方法 对 流 进行 修改 。 
简 而 言 之 ，concat 方法 适用 于 两 个 流 的 拼接 ， 可 以 作为 一 种 一 般 性 归 约 操作 使 用 ，flatMap 
方法 则 更 具 普 遍 意义 。 
另 见 
感 兴趣 的 话 可 以 阅读 一 篇 不 错 的 博文 “Efficient multiple-stream concatenation in Java”， 文 
章 描述 了 将 多 个 流 合并 为 一 个 流 时 需要 考虑 的 性 能 问题 。 
有 关 Stream.flatMap 方法 的 讨论 请 参见 范例 3.11。 


3.13 ” 情 性 流 

问题 

用 户 希 望 处 理 满足 条 件 所 需 的 最 小 数量 的 流 元 素 。 

方案 

流 是 惰性 的 ， 在 达到 终止 条 件 前 不 会 处 理 元 素 ， 达 到 终止 条 件 后 逐个 处 理 每 个 元 素 。 如 果 
遇 到 短路 操作 ， 那 么 只 要 满足 所 有 条 件 ， 流 处 理 就 会 终止 。 


讨论 
读者 在 第 一 次 接触 流 处 理 时 ， 很 容易 认为 流 处 理 的 效率 不 高 。 如 例 3-65 所 示 ， 我 们 将 100 
到 200 之 间 的 所 有 整数 倍增 ， 然 后 找 出 能 被 3 整除 的 第 一 个 整数 。 


































































































注 7: 感谢 Venkat Subramaniam 博士 为 本 例 所 做 的 贡献 。 
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例 3-65 将 100 到 200 之 间 的 所 有 整数 倍增 ， 再 找 出 能 被 3 整除 的 第 一 个 整数 
OptionalInt firstEvenDoubleDivBy3 = IntStream.range(100, 200) 
.map(n -> n * 2) 
.filter(n -> n % 3 == 0) 
.findFirst(); 
System.out.println(firstEvenDoubleDivBy3); © 


@ 打印 Optional[204] 

如 果 不 了 解 流 处 理 的 机 制 ， 读 者 可 能 认为 上 述 代 码 做 了 不 少 无 用 功 : 

。 创建 100 到 199 之 间 的 整数 (100 次 操作 ) 

。 将 每 个 整数 倍增 (100 次 操作 ) 

。 校 验 每 个 整数 能 否 被 3 整除 (100 次 操作 ) 

。 返回 结果 流 的 第 一 个 元 素 (1 次 操作 ) 

那么 ， 既 然 满 足 要 求 的 第 一 个 值 为 204， 为 什么 还 要 处 理 所 有 其 他 的 数字 呢 ? 

不 要 误会 ， 流 处 理 的 机 制 并 非 如 此 。 流 是 惰性 的 ， 在 达到 终止 条 件 前 不 会 处 理 元 素 ， 达 到 

终止 条 件 后 才 通 过 流水 线 逐 一 处 理 每 个 元 素 。 为 说 明 这 一 点 ， 例 3-66 对 代码 进行 重 构 ， 以 

便 读者 观 罕 每 个 元 素 通过 流水 线 时 的 情况 。 

例 3-66 对 每 个 流 元 素 进 行 显 式 处 理 
public int multByTwo(int n) { 0 


System.out.printf("Inside muLtByTwo with arg %d%n", n); 
return n * 2; 















































} 


public boolean divByThree(int n) { @ 
System.out.printf("Inside divByThree with arg %d%n", n); 
return Nn % 3 == 0; 


} 
// 其 他 代码 





firstEvenDoubleDivBy3 = IntStream.range(100, 200) 


.map(this: :multByTwo) 0 
.filter(this::divByThree) @ 
.findFirst(); 


@ 用 于 倍增 (并 打印 ) 的 方法 引用 
@ 用 于 对 3 取 模 (并 打印 ) 的 方法 引用 
例 3-66 的 输出 如 下 : 


Inside multByTwo with arg 100 
Inside divByThree with arg 200 
Inside multByTwo with arg 101 
Inside divByThree with arg 202 
Inside multByTwo with arg 102 
Inside divByThree with arg 204 
First even divisible by 3 is Optional[204] 
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在 本 例 中 ，100 被 映射 到 200， 它 未 通过 筛选 器 ， 流 移 至 101，101 被 映射 到 202， 它 同样 
未 通过 筛选 器 ， 下 一 个 值 102 被 映射 到 204， 它 能 被 3 整除 ， 因 此 通过 筛选 器 。 流 处 理 在 
仅 处 理 三 个 值 后 即 告终 止 ， 一 共 进 行 了 6 次 操作 。 

这 是 流 处 理 相对 于 直接 处 理 集合 的 最 大 优点 之 一 。 对 集合 而 言 ， 必 须 执 行 完 所 有 操作 才能 
进行 下 一 步 操 作 。 对 流 而 言 ， 各 种 中 间 操 作 构 成 了 一 条 流水 线 ， 但 流 在 达到 终止 操作 前 不 
会 处 理 任何 元 素 ， 达 到 终止 操作 后 只 处 理 所 需 的 值 。 

流 处 理 并 非 在 任何 情况 下 都 有 意义 : 如 果 进 行 任何 状态 操作 (如 排序 或 求 和 )， 就 不 得 不 处 
理 所 有 值 。 但 是 ， 如 果 无 状态 操作 后 跟 一 个 短路 终止 操作 ， 流 处 理 的 优点 还 是 很 明显 的 。 




























































































另 见 
有 关 findFirst 和 findAny 方法 之 间 的 差异 请 参见 范例 3.9。 
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比较 器 与 收集 器 





Java 8 为 java.util.Comparator 接口 新 增 了 多 种 静态 和 默认 方法 ， 使 排序 操作 变 得 更 为 简 
单 。 现 在 ， 只 需 通 过 一 系列 库 调 用 ， 就 能 根据 一 个 属性 对 POJO 集合 进行 排序 。 


Java 8 还 引入 了 一 个 新 的 工具 类 java.util.stream.Collectors， 它 提供 将 流转 换 回 各 类 和 集 
合 所 需 的 静态 方法 。 此 外 ， 收 集 器 也 可 以 在 “下 游 ” 使 用 ， 利 用 它们 对 分 组 (grouping) 
或 分 区 (partitioning) 操作 进行 后 期 处 理 。 


这 一 章 的 范例 将 讨论 上 述 各 种 概念 。 
4.1 利用 比较 器 实现 排序 


问题 

用 户 和 希望 实现 对 象 的 排序 。 

方案 

使 用 传 入 Comparator 的 Stream.sorted 方法 ，Comparator 既 可 以 通过 lambda 表达 式 实现 ， 
也 可 以 使 用 Comparator 接口 定义 的 某 种 comparing 方法 生成 。 

讨论 


Stream.sorted 方法 根据 类 的 自然 顺序 (natural ordering) 生成 一 个 新 的 排序 流 ， 自 然 顺 序 
是 通过 实现 java.util.Comparable 接口 来 指定 的 。 


如 例 4-1 所 示 ， 我 们 对 字符 串 集 合 进 行 排序 。 
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例 4-1 根据 字典 序 (自然 顺序 ) 对 字符 串 排 序 
private List<String> sampleStrings = 
Arrays.asList("this", "is", "a", "list", "of", "strings"); 


public List<String> defaultSort() { 
Collections.sort(sampleStrings); ©@ 
return sampleStrings; 


} 


public List<String> defaultSortUsingStreams() { 
return sampleStrings.stream() 
.Sorted() 
.COLLect(CoLLectors .toList() ); 


} 
@ 默认 排序 (Java7 及 之 前 的 版 本 ) 
@ 默认 排序 (Java 8 及 之 后 的 版 本 ) 


从 Java 1.2 引入 集合 框架 (collections framework) 开始 ， 工 具 类 Collections 就 已 存在 。 
Collections 类 定义 的 静态 方法 sort 传人 List 作为 参数 ， 但 返回 void。 这 种 排序 是 破坏 性 
的 ， 会 修改 所 提供 的 集合 。 换 言 之 ，Collections.sort 方法 不 符合 Java 8 所 倡导 的 将 不 可 
变性 (immutability) 置 于 首要 位 置 的 函数 式 编程 原则 。 


Java 8 采用 Stream.sorted 方法 实现 相同 的 排序 ， 但 不 对 原始 集合 进行 修改 ， 而 是 生成 一 
个 新 的 流 。 在 例 8-1 中 ， 完 成 集合 的 排序 后 ， 程 序 根据 类 的 自然 顺序 对 返回 列表 进行 排序 。 
对 于 字符 串 ， 自 然 顺序 是 字典 序 (lexicographic order) ; 如 果 所 有 字符 串 均 为 小 写 ， 自 然 
顺序 就 相当 于 字母 顺序 (alphabetical order) ， 从 本 例 可 以 观察 到 这 一 点 。 


如 果 和 希望 以 其 他 方式 排序 字符 串 ， 可 以 使 用 sorted 方法 的 重 载 形式 ， 传 入 Comparator 作 


例 4-2 采用 两 种 不 同 的 方式 ， 根 据 长 度 对 字符 串 进 行 排序 。 
例 4-2 ”根据 长 度 对 字符 串 排序 


public List<String> lengthSortUsingSorted() { 
return sampleStrings.stream() 
.sorted((s1i, s2) -> si1.length() - s2.Length()) © 
.collect(toList()); 






































} 


public List<String> LengthSortUsingComparator() { 

return sampleStrings.stream() 
.Sorted(Comparator .comparingInt(String::length)) ©@ 
.collect(toList()); 


} 
@ 使 用 lambda 表达 式 作 为 Comparator， 根 据 长 度 进行 排序 
@ 使 用 Comparator .comparingInt 方法 


sorted 方法 的 参数 为 java.util.Comparator， 它 是 一 种 函数 式 接 口 。 对 于 第 一 个 方法 
lengthsortUsingSorted， 所 提供 的 lambda 表达 式 用 于 实现 Comparator .compare 方 法。 在 
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Java7 及 之 前 的 版 本 中 ， 实 现 通 常 由 匿名 内 部 类 提供 ， 而 本 例 仅 需要 一 个 lambda 表达 式 。 


Java 8 引入 sort(Comparator) 作为 List 接口 的 默认 实例 方法 ， 它 相当 于 
Collections 类 的 sort(List， Comparator) 方法 。 由 于 两 种 方法 返回 votd 且 
都 是 破坏 性 的 ， 本 节 讨 论 的 Stream.sorted(Comparator) 方法 (返回 一 个 新 的 
排序 流 ) 仍然 是 首选 方案 。 











第 二 个 方法 LengthSsortUsingComparator 利用 了 Comparator 接口 新 增 的 某 种 静态 方法 。 
comparingInt 方法 传人 一 个 ToIntFunction 类 型 的 参数 (文档 称 之 为 keyExtractor)， 用 于 
将 字符 串 转 换 为 整 型 数据 ， 并 生成 一 个 使 用 该 keyExtractor 对 集合 进行 排序 的 Comparator。 


Comparator 接口 新 增 的 各 种 默认 方法 极为 有 用 。 虽 然 不 难 写 出 一 个 根据 长 度 进行 排序 的 
Comparator， 但 如 果 需 要 对 多 个 字段 排序 ， 代 码 可 能 会 变 得 很 复杂 。 例 如 ， 我 们 希望 根据 
长 度 对 字符 串 排 序 ， 如 果 长 度 相同 则 按 字 母 顺 序 排序 。 如 例 4-3 所 示 ， 采 用 Comparator 接 
口 提供 的 默认 和 静态 方法 很 容易 就 能 解决 这 个 问题 。 


例 4-3 根据 长 度 对 字符 串 排 序 ， 长 度 相同 则 按 字母 顺序 排序 
public List<String> lengthSortThenAlphaSort() { 
return sampleStrings.stream() 
.Sorted(comparing(String::length) 
.thenComparing(naturalOrder())) 
.Collect(toList()); 
































} 
@ 根据 长 度 对 字符 串 排序 ， 长 度 相 同 则 按 字母 顺序 排序 


Comparator 接口 定义 了 一 个 称 为 thenComparing 的 默认 方法 。 与 comparing 方法 类 似 ， 
thenComparing 方法 也 传 入 Function 作为 参数 ， 文 档 同 样 将 其 称 为 keyExtractor。 如 果 将 
thenComparing 方法 链接 到 comparing 方法 会 返回 Comparator， 它 首先 比较 第 一 个 数量 ， 如 
果 相 同 则 比较 第 二 个 数量 ， 以 此 类 推 。 


静态 导入 通常 使 代码 更 易于 阅读 。 一 旦 熟悉 Comparator 接口 和 Collectors 类 定义 的 各 种 
静态 方法 ， 就 能 写 出 更 简单 的 代码 。 在 本 例 中 ，comparing 和 naturaLorder 方法 已 被 静态 
导入 。 


即便 没有 实现 Comparable 接口 ， 上 述 方案 也 适用 于 任何 类 。 如 例 4-4 所 示 ， 我 们 定义 一 个 
描述 高 尔 夫 球 手 的 Golfer 类 。 


例 4-4 描述 高 尔 夫 球 手 的 Golfer 类 
public class GoLfer { 
private String first; 
private String last; 
private int score; 

















// 其 他 方法 
} 
为 了 创建 一 个 高 尔 夫 锦 标 赛 排行 榜 ， 可 以 依次 根据 各 个 球 手 的 得 分 、 姓 氏 、 名 字 进 行 排 
序 。 例 4-5 显示 了 如 何 实现 高 尔 夫 球 手 的 排序 。 
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例 4-5 对 高 尔 夫 球 手 排序 

private List<Golfer> golfers = Arrays.asList( 
new Golfer("Jack", "Nicklaus", 68), 
new Golfer("Tiger", "Woods", 70), 
new Golfer("Tom", "Watson", 70), 
new Golfer("Ty", "Webb", 68), 
new Golfer("Bubba", "Watson", 70) 

)3 


public List<Golfer> sortByScoreThenLastThenFirst() { 
return golfers.stream() 
.sorted(comparingInt(Golfer::getScore) 
.thenComparing(Golfer::getLast) 
.thenComparing(Golfer::getFirst)) 
.collect(toList()); 
} 


调用 sortByScoreThenLastThenFirst 方法 ， 输 出 如 例 4-6 所 示 。 
例 4-6 对 高 尔 夫 球 手 排序 后 的 结果 


Golfer{first='Jack', last='Nicklaus', score=68} 

Golfer{first='Ty', last='Webb', score=68} 

Golfer{first='Bubba', last='Watson', score=70} 

Golfer{first='Tom', last='Watson', score=70} 

Golfer{first='Tiger', last='Woods', score=70} 
本 例 首先 根据 得 分 对 各 个 球 手 进 行 排序 , 因此 Jack Nicklaus 和 Ty Webb' 排 在 Tiger Woods、 
Bubba Watson 与 Tom Watson 之 前 。 得 分 相同 时 根据 姓氏 进行 排序 ， 因 此 Jack Nicklaus 排 
在 Ty Webb 之 前 ，Bubba Watson 和 Tom Watson 排 在 Tiger Woods 之 前 。 如 果 得 分 和 姓氏 
都 相同 ， 则 根据 名 字 进 行 排序 ， 因 此 Bubba Watson 排 在 Tom Watson 之 前 。 
借 由 Comparator 接口 定义 的 默认 和 静态 方法 以 及 Stream 接口 新 增 的 sorted 方法 ， 生 成 复 
杂 的 排序 变 得 易如反掌 。 


4.2 ”将 流转 换 为 集合 
问题 
流 处 理 完 成 之 后 ， 用 户 希 望 将 流转 换 为 List、Set 或 其 他 线性 集合 。 


方案 


使 用 CoLLectors 工具 类 定义 的 toList、toSet 或 toCoLLection 方法 。 

































































注 1: 当然 ,Ty Webb 是 电影 《小 小 球 童 》 中 的 角色 。Judge Smails 问 道 :“ 今 天 打 得 怎么 样 ? ”Ty Webb 回答 : 
“我 没有 计 分 。 Smails 继续 问 道 :“ 那 你 怎么 衡量 自己 与 其 他 球 手 的 水 平 呢 ? ”Webb 回答 :“ 身 高 。 
根据 身高 进行 排序 留 给 读者 作为 简单 的 练习 。 



































入 后 
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讨论 

Java 8 一 般 通 过 称 为 流水 线 (pipeline) 的 中 间 操 作 (intermediate operation) 来 传递 流 元 
素 ， 并 在 达到 终止 操作 (terminal operation) 后 结束 。Strean 接口 定义 的 collect 方法 就 是 
一 种 终止 操作 ， 用 于 将 流转 换 为 集合 。 


collect 方法 有 两 种 重 载 形式 ， 如 例 4-7 所 示 。 


例 4-7 Stream.collect 方 法 


<R,A> R collect(Collector<? super T,A,R> collector) 

<R> R collect(Supplier<R> supplier, 
BiConsumer<R,? suyper T> accumulator, 
BiConsumer<R,R> combiner) 


本 范例 采用 第 一 种 形式 ， 它 传 入 Collector 作为 参数 。 收 集 器 执行 “可 变 归 和约 操作 ” 
(mutable reduction operation) ， 将 元 素 累加 至 结果 容器 (result container) ， 此 时 结果 是 一 个 
集合 。 

由 于 java.util.stream.Collector 属于 接口 ， 无 法 被 实例 化 。Collector 接口 包含 一 个 称 为 
of 的 静态 方法 ， 它 用 于 生成 Collector， 但 通常 有 更 好 (或 至 少 更 简单 ) 的 方式 可 以 实现 


这 一 点 


\o 





Java 8 API 经 常 使 用 静态 方法 of 作为 工厂 方法 。 








Collectors 类 定义 的 静态 方法 将 用 于 生成 CoLLector 实例 ， 它 作为 Stream.collect 方法 的 
参数 来 填充 集合 。 


例 4-8 显示 了 一 个 创建 List 的 简单 示例 。 
例 4-8 创建 List 


List<String> superHeroes = 
Stream.of("Mr. Furious", "The Blue Raja", "The Shoveler", 
"The Bowler", "Invisible Boy", "The Spleen", "The Sphinx") 
.Collect(Collectors. toList()); 


上 述 方法 创建 了 一 个 ArrayList 类 ， 并 采用 给 定 的 流 元 素 进 行 填充 。 创 建 set 也 很 简单 ， 
如 例 4-9 所 示 。 
例 4-9 创建 Set 

Set<String> villains = 


Stream.of("Casanova Frankenstein", "The Disco Boys", 
"The Not-So-Goodie Mob", "The Suits", "The Suzies", 




















注 2: 本 范例 中 出 现 的 人 名 来 自 《 神 秘 兵 团 》 这 是 20 世纪 90 年 代 最 为 人 所 忽视 的 电影 之 一 。(Furious 说 : 
“Lance Hunt 就 是 神奇 队长 。” Shoveler 答 道 :“Lance Hunt 戴 眼镜 , 但 神奇 队长 不 戴 .。”Furious 说 :“ 他 
变 身 时 会 把 眼镜 摘 下 来 。 Shoveler 答 道 :“ 怎 么 可 能 ! 他 根本 看 不 见 ! ”) 
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"The Furriers", "The Furriers") © 
.Collect(Collectors. toSet()); 
} 


@ 重复 的 人 名 (将 在 转换 为 Set 时 删除 ) 

上 述 方法 创建 了 一 个 Hashset 类 的 实例 并 加 以 填充 ， 并 忽略 任何 重复 的 人 名 。 

例 4-8 和 例 4-9 均 使 用 默认 的 数据 结构 : 对 于 List 是 ArrayList， 对 于 Set 是 Hashset。 
如 果 和 希望 指定 某 种 特定 的 数据 结构 ， 则 应 使 用 Collectors.toCollection 方法 ， 它 传人 
Supplier 作为 参数 。 示 例 代 码 如 例 4-10 所 示 。 

例 4-10 创建 关联 列表 (linked list) 


List<String> actors = 
Stream.of("Hank Azaria", "Janeane Garofalo", "William H. Macy", 
"Paul Reubens", "Ben Stiller", "Kel Mitchell", "Wes Studi") 
.Collect(Collectors.toCollection(LinkedList: :new)); 




















} 


由 于 toCollection 方法 的 参数 是 集合 Supplier ， 本 例 提 供 LinkedList 类 的 构造 函数 引用 。 
collect 方法 将 LinkedList 实例 化 ， 并 采用 给 定 的 姓名 加 以 填充 。 
Strean 接口 还 定义 了 一 个 用 于 创建 对 象 数组 的 方法 toArray， 它 有 两 种 重 载 形式 ， 

Object[] toArray() ; 

<A> A[] toArray(IntFunction<A[]> generator); 

一 种 形式 返回 一 个 包含 流 元 素 的 数组 ， 但 未 指定 类 型 。 第 二 种 形式 传人 一 个 国 数 并 生成 
SR 数组 的 长 度 与 流 相同 ， 很 容易 与 数组 构造 函数 引用 (array constructor 
reference) 一 起 使 用 ， 如 例 4-11 所 示 。 

例 4-11 创建 Array 

String[] wannabes = 


Stream.of("The Waffler", "Reverse Psychologist", "PMS Avenger") 
.toArray(String[]::new); © 


























} 
@ 数组 构造 函数 引用 作为 Supplier 
返回 数组 具有 指定 的 类 型 ， 其 长 度 与 流 中 的 元 素数 量 匹配 。 
为 了 将 流转 换 为 ap，CcotLectors.tonap 方法 需要 传人 两 个 Function 实例 ， 分 别 用 于 键 和 值 。 


我 们 以 一 个 包装 name 和 role 的 Actor POJO 为 例 进行 讨论 。 假 设 一 部 给 定 电 影 中 存在 
Actor 实例 的 Set， 例 4-12 根据 这 些 实例 创建 了 一 个 Map。 


例 4-12 创建 Map 


Set<Actor> actors = mysteryMen.getActors(); 




















Map<String, String> actorMap = actors.stream() 
.collect(Collectors.toMap(Actor::getName, Actor::getRole)); © 


actorMap.forEach((key,value) -> 
System.out.printf("%s played %s%n", key, value)); 











@ 生成 键 和 值 所 用 的 函数 
输出 如 下 : 


Janeane Garofalo played The Bowler 

Greg Kinnear played Captain Amazing 
William H. Macy played The Shoveler 

Paul Reubens played The Spleen 

Wes Studi played The Sphinx 

Kel Mitchell played Invisible Boy 
Geoffrey Rush played Casanova Frankenstein 
Ben Stiller played Mr. Furious 

Hank Azaria played The Blue Raja 


利用 Collectors.toConcurrentMap 方法 对 本 例 稍 作 修改 ， 就 能 创建 ConcurrentMap。 























另 见 
有 关 Supplier 接口 的 讨论 请 参见 范例 2.2， 有 关 构 造 国 数 引用 的 讨论 请 参见 范例 1.3， 有 关 
toMap 方法 的 讨论 请 参见 范例 4.3。 


4.3 将 线性 集合 添加 到 映射 


问题 

用 户 希 望 将 对 象 集合 添加 到 Map， 甚 中 键 为 某 种 对 象 属性 ， 值 为 对 象 本 身 。 

方案 

使 用 CoLLectors 类 定义 的 toMap 方法 以 及 Function 接口 定义 的 identity 方法 。 

讨论 

这 是 一 个 简短 且 非 常 集中 的 用 例 ， 但 本 节 讨 论 的 解决 方案 可 能 为 实际 开发 提供 很 大 便利 。 


假设 存在 一 个 由 Book 实例 构成 的 List。Book 是 一 个 简单 的 POJO， 由 ID、 书 名 、 价 格 参 
数 构成 。Book 类 的 简单 形式 如 例 4-13 所 示 。 


例 4-13 Book 类 (描述 图 书 的 简单 POJO) 
public class Book { 
private int id; 
private String name; 
private double price; 












































// 其 他 方法 


此 外 ， 假 设 存在 一 个 由 Book 实例 构成 的 集合 ， 如 例 4-14 所 示 。 
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例 4-14 图 书 集 合 

List<Book> books = Arrays.asList( 
new Book(1, "Modern Java Recipes", 49.99), 
new Book(2, "Java 8 in Action", 49.99), 
new Book(3, "Java SE8 for the Really Impatient", 39.99), 
new Book(4, "Functional Programming in Java", 27.64), 
new Book(5, "Making Java Groovy", 45.99) 
new Book(6, "Gradle Recipes for Android", 23.76) 

9 


很 多 情况 下 ， 我 们 需要 的 可 能 是 Map 而 非 List，Map 的 键 为 图 书 ID ， 值 为 图 书本 身 。 借 由 
Collectors.toMap 方法 ， 很 容易 就 能 将 图 书 添加 到 Map， 例 4-15 显示 了 两 种 不 同 的 方案 。 
例 4-15 将 图 书 添加 到 Map 


Map<Integer, Book> bookMap = books.stream() 
.Collect(Collectors.toMap(Book: :getId, b -> b)); 0 
































bookMap = books.stream() 
.collect(Collectors.toMap(Book: :getId, Function.identity())); ©@ 


@ lambda 标识 : 给 定 一 个 元 素 并 返回 
@ 静态 方法 Function.identity 可 以 实现 同样 的 目的 


toMap 方法 传 入 两 个 Function 实例 作为 参数 ， 根 据 所 提供 的 对 象 ， 两 个 函数 分 别 生 成 键 和 
值 。 在 本 例 中 ， 键 由 Book: :getId 映射 ， 值 为 图 书本 身 。 

可 以 看 到 ， 第 一 个 toMap 方法 传 入 两 个 参数 ， 一 个 是 映射 到 键 的 getId， 另 一 个 是 返回 参 
数 的 显 式 lambda 表达 式 。 第 二 个 toMap 方法 通过 静态 方法 Function.identity 实现 相同 的 
目的 。 

















两 种 静态 identity 方法 
静态 方法 Function.identity 的 签名 如 下 : 
static <T> Function<T,T> identity() 
它 在 Java 标准 库 中 的 实现 如 例 4-16 所 示 。 


例 4-16 Function.identity 方法 
static <T> Function<T, T> identity() { 
return 七 -> t; 
} 
UnaryOperator 接口 是 Function 的 子 接口 ， 但 无 法 重 写 静态 方法 。 根 据 Javadoc 的 描述 ， 
UnaryOperator 接口 也 声明 了 一 个 称 为 identity 的 静态 方法 : 


static <T> UnaryOperator<T> identity() 


UnaryOperator .identity 方法 在 Java 标准 库 中 的 实现 与 Function.identity 方法 基本 相 
同 ， 如 例 4-17 所 示 。 











例 4-17 Unary0perator.identity 方法 


static <T> UnaryOperator<T> identity() { 
return 七 -> 七 ; 


二 者 的 区 别 仅 在 于 调用 方式 (不同 的 接口 名 ) 和 相应 的 返回 类 型 有 所 不 同 。 使 用 哪 种 
identity 方法 均 可 ， 这 里 将 两 种 方法 列 出 供 读者 参考 。 

无 论 是 提供 显 式 的 lambda 表达 式 抑 或 使 用 静态 方法 ， 只 是 编程 风格 不 同 而 已 。 两 种 方 
案 都 能 很 容易 地 将 集合 值 添 加 到 Map， 其 中 键 为 对 象 的 属性 ， 值 为 对 象 本 身 。 








另 见 


有 关 Function 接口 、 一 元 运算 符 与 二 元 运算 符 的 讨论 请 参见 范例 2.4。 


4.4 ”对 映射 排序 


问题 

用 户 希 望 根据 键 或 值 对 Map 排序 。 
方案 

使 用 Map.Entry 接口 新 增 的 静态 方法 。 


讨论 

Map 接口 始终 包含 一 个 称 为 Map.Entry 的 公共 静态 内 部 接口 (public, static, inner interface)， 
它 表 示 一 个 键 值 对 。Map 接口 定义 的 entrySet 方法 返回 Map.Entry 元 素 的 Set。 在 Java 8 
之 前 ，getKey 和 getValue 是 Map.Entry 接口 两 种 最 常用 的 方法 ， 二 者 分 别 返回 与 某 个 条 目 
对 应 的 键 和 值 。 

Java 8 为 Map.Entry 接口 引入 了 一 些 新 的 静态 方法 ， 如 表 4-1 所 示 。 

表 4-1 Map.Entry 接 口 新 增 的 静态 方法 (参见 Java 8 文档 ) 

方法 描述 

可 一 个 比较 器 ， 它 根据 键 的 自然 顺序 比较 Map.Entry 

可 一 个 比较 器 ， 它 使 用 给 定 的 Comparator 并 根据 键 

较 Map.Entry 

可 一 个 比较 器 ， 它 根据 值 的 自然 顺序 比较 Map.Entry 


器 一 个 比较 器 ， 它 使 用 给 定 的 Comparator 并 根据 值 
较 Map.Entry 



































comparingByKey() 











comparingByKey(Comparator<? super K> cmp) 











comparingByValue() 














comparingByValue(Comparator<? super V> cmp) 
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我 们 以 创建 单词 长 度 与 单词 数量 的 Map 为 例 ， 演 示 上 述 方法 的 用 法 ( 例 4-18)。 所 有 Unix 
系统 的 usr/share/dict/words 目录 中 都 包含 一 个 文件 ， 它 收录 了 《 韦 氏 词典 (第 2 版 )》 的 内 
容 ， 每 个 单词 在 文件 中 占据 一 行 。Files.lines 方法 可 用 于 读 取 文件 并 生成 一 个 包含 这 些 
行 的 字符 串 流 。 此 时 ， 流 包含 词典 中 的 所 有 单词 。 


例 4-18 将 词典 文件 读 入 Map 
System.out.println("\nNumber of words of each length:"); 
try (Stream<String> lines = Files.lines(dictionary)) { 
lines.filter(s -> s.length() > 20) 
.collect(Collectors.groupingBy( 
String::length, Collectors.counting())) 
.forEach((len, num) -> System.out.printf("%d: %d%n", len, num)); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
本 例 的 详细 讨论 请 参见 范例 7.1， 目 前 可 以 这 样 理解 。 


。 文件 在 try-with-resources 代码 块 内 读 取 。 由 于 Stream 接口 实现 了 AutoCloseable， 
try 代码 块 执行 完毕 后 ，Java 对 Strean 调用 close 方法 ， 然 后 对 File 调用 close 方法 。 

。 租 选 绒 只 算出 长 度 至 少 为 20 个 字符 的 单词 ， 以 供 进一步 处 理 。 

。 Collectors.groupingBy 方法 传 入 Function 作为 第 一 个 参数 ， 表 示 分 类 器 (classifier) 。 

在 本 例 中 ， 分 类 器 是 每 个 字符 串 的 长 度 。 如 果 groupingBy 方法 只 传人 一 个 参数 ， 则 

结果 为 Map， 其 中 键 为 分 类 器 的 值 ， 值 为 匹配 分 类 器 的 元 素 列 表 。 这 种 情况 下 ， 
groupingBy(String::Length) 将 返回 Map<Integer,List<String>>， 其 中 键 为 单词 长 度 ， 
值 为 该 长 度 的 单词 列表 。 

。 在 本 例 中 ， 双 参数 形式 的 groupingBy 方法 传 入 男 一 个 CoLLector ， 它 称 为 下 游 收集 器 
(downstream collector) ， 用 于 对 单词 列表 进行 后 期 处 理 。 这 种 情况 下 ，groupingBy 方法 
的 返回 类 型 是 Map<Integer ,Long>， 其 中 键 为 单词 长 度 ， 值 为 词典 中 该 长 度 的 单词 数量 。 


例 4-18 的 输出 结果 如 下 : 


Number of words of each length: 





















































换言之 ， 有 82 个 单词 的 长 度 为 21，41 个 单词 的 长 度 为 22，17 个 单词 的 长 度 为 23，5 个 
单词 的 长 度 为 24 。 


不 难看 到 ， 程 序 按 单词 长 度 的 升序 打印 映射 中 的 单词 。 如 果 和 希望 按 降序 打印 ， 可 以 使 用 
Map.Entry 接口 定义 的 comparingByKey 方法 ， 如 例 4-19 所 示 。 



































注 3: 根据 记录 ， 这 5 个 最 长 的 单词 为 formaldehydesulphoxylate (甲醛 次 硫酸 氮 钠 )、pathologicopsychological 
(病理 心理 学 )、scientificophilosophical (科学 哲学 )、tetraiodophenolphthalein (四 碘 酚 栈 ) 以 及 
thyroparathyroidectomize (甲状 腺 甲状 腺 切除 术 )。 和 希望 拼写 检查 工具 可 以 识别 这 些 单词 。 
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例 4-19 根据 键 对 映射 排序 


System.out.println("\nNumber of words of each Length (desc order):"); 


try (Stream<String> Lines = Files.lines(dictionary)) { 
Map<Integer, Long> map = lines.filter(s -> s.length() > 20) 
.collect(Collectors.groupingBy( 
String::length, Collectors.counting())); 


map.entrySet().stream() 


.Sorted(Map.Entry.comparingByKey(Comparator.reverseOrder())) 


.forEach(e -> System.out.printf("Length %d: %2d words%n", 
e.getKey(), e.getValue())); 
} catch (IOException e) { 
e.printStackTrace(); 


} 


返回 Map<Integer ,Long> 之 后 ， 程 序 将 提取 entrySet 并 产生 一 个 流 。Stream.sorted 方法 使 








用 提供 的 比较 器 生成 经 过 排序 的 流 。 














在 本 例 中 ，comparingByKey 方法 返回 一 个 根据 键 进 行 排序 的 比较 器 。 如 果 希 望 以 键 的 相反 


顺序 排序 ， 可 以 使 用 comparingByKey 方法 的 重 载 形式 ， 它 传人 比较 器 作为 参数 。 


原始 Map 不 受 影 响 。 























例 4-19 的 输出 结果 如 下 : 


Number of words of each length (desc order): 
Length 24: 5 words 
Length 23: 17 words 
Length 22: 41 words 
Length 21: 82 words 


表 4-1 列 出 的 comparingByValue 方法 ， 用 法 与 comparingByKey 类 似 。 


另 见 


Stream.sorted 方法 生成 一 个 新 的 排序 流 ， 它 不 对 源 数据 进行 修改 。 换 言 之 ， 


有 关 根 据 键 或 值 对 Map 进行 排序 的 其 他 示例 请 参见 附录 A， 有 关 下 游 收 集 器 的 讨论 请 参见 





范例 4.6， 有 关 词 典 中 的 文件 处 理 请 参见 范例 7.1。 


4.5 ”分 区 与 分 组 





比较 器 与 收集 器 


方案 
Collectors.partitioningBy 方法 将 元 素 拆 分 为 满足 Predicate 与 不 满足 Predicate 的 两 类 
Collectors.groupingBy 方法 生成 一 个 由 类 别 构成 的 Nap， 其 中 值 为 每 个 类 别 中 的 元 素 
讨论 
假设 存在 一 个 由 字符 串 构 成 的 集合 ， 可 以 通过 partitioningBy 方法 将 这 些 字符 串 按 偶数 长 
度 和 奇数 长 度 进行 划分 ， 如 例 4-20 所 地。 

例 4-20 ”根据 偶数 或 奇数 长 度 对 字符 串 分 


List<String> strings = Arrays.asList("this", "is" 


is", J "Long", "list", "of", 
"strings", On "use" ， "as ya "demo"); 





xl 


Map<Boolean, List<String>> lengthMap = strings.stream() 
.collect(Collectors.partitioningBy(s -> s.length() % 2 == 0)); © 


lengthMap.forEach( (key,value) 
// 


// false: [a, strings, use, al] 
// true: [this, is, long, list, of, to, as, demol] 


@ 根据 偶数 或 奇数 长 度 进行 分 
partitioningBy 方法 包括 两 种 形式 .: 


-> System.out.printf("%5s: %s%n", key, value)); 


xl 





static <T> Collector<T,?,Map<Boolean,List<T>>> partitioningBy( 
Predicate<? super T> predicate) 


static <T,D,A> Collector<T,?,Map<Boolean,D>> partitioningBy( 
Predicate<? super T> predicate, Collector<? super T,A,D> downstream) 


可 以 看 到 ， 返 回 类 型 中 涉及 泛 型 (generics) ， 因 此 略 显 复杂 ， 不 过 实际 开发 中 很 少 会 用 到 

它们 。 两 种 partitioningBy 方法 的 结果 成 为 cotlect 方法 的 参数 ， 该 方法 使 用 生成 的 收集 
器 来 创建 由 第 三 个 泛 型 参数 定义 的 输出 映射 。 

一 种 partitioningBy 方法 传人 单个 Predicate 作为 参数 ， 


与 不 满足 Predicate 的 两 类 。 我 们 总 是 可 以 得 到 一 个 
值 列 表 满 足 Predicate， 另 一 个 则 不 满足 Predicate。 


partitioningBy 方法 的 重 载 形 式 传 入 Collector 作为 第 二 个 参数 
支持 对 分 区 返回 的 列表 进行 后 期 处 理 ， 相 关 讨论 请 参见 范例 4.6。 


而 groupingBy 方法 执行 的 操作 类 似 于 SQL 的 GROUP BY 语句 。 该 方法 返回 一 个 Map， 其 中 
键 为 分 组 ， 值 为 各 个 分 组 中 的 元 素 列 表 。 




















它 将 元 素 分 为 满足 Predicate 
恰好 包含 两 个 条 目的 ap， 其 中 一 个 


它 称 为 下 游 收集 器 。 它 
































如 果 从 数据 库 获 取 数据 ， 请 务必 将 分 组 操作 放 在 数据 库 中 执行 ， 因 为 Java 8 
新 增 的 方法 适合 处 理 内 存 中 的 数据 。 





groupingBy 方法 的 签名 如 下 : 
static <T,K> Collector<T,?,Map<K,List<T>>> groupingBy( 
Function<? super T,? extends K> classifier) 
Function 参数 传 入 流 的 各 个 元 素 ， 并 提取 需要 分 组 的 元 素 。 接 下 来 ， 我 们 不 是 将 字符 串 简 
单 地 分 为 两 类 ， 而 是 根据 长 度 进行 划分 ， 如 例 4-21 所 示 。 
例 4-21 根据 长 度 对 字符 串 分 组 


List<String> strings = Arrays.asList("this", "is", "a", "long", "list", "of", 
"strings", "to", "use", "as", "a", "demo"); 





Map<Integer, List<String>> lengthMap = strings.stream() 
.collect(Collectors.groupingBy(String::length)); © 


lengthMap.forEach((k,v) -> System.out.printf("%d: %s%n", k, v)); 


// 1: [a, al 

// 2: [is, of, to, as] 

// 3: [use] 

// 4: [this, long, list, demo] 
// 7: [strings] 


@ 根据 长 度 进行 分 组 
对 于 所 生成 的 映射 ， 键 为 字符 串 长 度 (1、2、3、4、7)， 值 为 各 个 长 度 的 字符 串 列 表 。 


另 见 
作为 对 本 范例 的 延伸 ， 范 例 4.6 将 讨论 如 何 对 groupingBy 或 partitioningBy 操作 返回 的 列 
表 进 行 后 期 处 理 。 


4.6 下游 收集 器 


问题 

用 户 希 望 对 groupingBy 或 partitioningBy 操作 返回 的 集合 进行 后 期 处 理 。 

方案 

使 用 java.util.stream.Collectors 类 定义 的 某 种 静态 工具 方法 。 

讨论 

有 关 将 元 素 划 分 为 多 个 类 别 的 讨论 请 参见 范例 4.5。groupingBy 和 partitioningBy 方法 
返回 的 是 Map， 其 中 键 为 类 别 (对 于 partitioningBy 方法 是 布尔 值 true 或 faLse， 对 于 


groupingBy 方法 是 对 象 )， 值 为 满足 各 个 类 别 的 元 素 列 表 。 读 者 或 许 还 记得 根据 偶数 和 奇 
数 长 度 对 字符 串 进 行 分 区 的 示例 〈 例 4-20)， 为 便于 参考 ， 例 4-22 完整 复制 了 这 个 示例 。 
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例 4-22 ”根据 偶数 或 奇数 长 度 对 字符 串 分 区 
List<String> strings = Arrays.asList("this", 
"strings", "to", "use", " 





E23 


is", Dy "long", "List" ， "of" ， 
as"， va "demo"); 


Map<Boolean, List<String>> lengthMap = strings.stream() 
.collect(Collectors.partitioningBy(s -> s.length() % 2 == 0)); 


LengthMap .forEach((key,vaLue) -> System.out.printf("%5s: %s%n", key, value)); 
// 


// false: [a, strings, use, a] 
// true: [this, is, long, list, of, to, as, demo] 


较 之 实际 的 列表 ， 我 们 或 许 对 每 个 类 别 包含 多 少 元 素 更 感 兴趣 。 换 言 之 ， 我 们 可 能 只 需要 
各 个 列表 中 的 元 素数 量 ， 而 不 是 返回 Map ( 值 为 List<sString>)。partitioningBy 方法 的 重 
载 形式 如 下 ， 其 第 二 个 参数 为 Collector 类 型 : 


static <T,D,A> Collector<T,?,Map<Boolean,D>> partitioningBy( 
Predicate<? super T> predicate, Collector<? super T,A,D> downstream) 


静态 方法 Collectors.counting 的 作用 就 在 于 此 ， 其 用 法 如 例 4-23 所 示 。 
例 4-23 对 已 分 区 的 字符 串 进行 计数 


Map<Boolean, Long> numberLengthMap = strings.stream() 
.collect(Collectors.partitioningBy(s -> s.length() % 2 == 0， 
Collectors.counting())); © 





numberLengthMap.forEach((k,v) -> System.out.printf("%5s: %d%n", k, v)); 


// 
// false: 4 


// true: 8 
@ 下 游 收 集 器 
这 就 是 所 谓 的 下 游 收集 器 ， 它 对 下 游 的 结果 列表 ( 即 在 分 区 操作 完成 之 后 ) 进行 后 期 处 理 。 
groupingBy 方法 也 有 一 种 传 入 下 游 收 集 器 的 重 载 形式 : 




















* 
* 


@param <T>: 输入 元 素 的 类 型 

@param <K>: 键 的 类 型 

@param <A>: 下 游 收集 器 的 中 间 累 加 类 型 

@param <D>: 下 游 归 约 操作 的 结果 类 型 

@param cLassifier: 将 输入 元 素 映 射 到 键 的 分 类 器 函数 
@param downstream: 实现 下 游 归 约 操作 的 CoLLector 
@return: 实现 级 联 分 组 操作 的 CoLLector 





本 和， 


8/ 

static <T,K,A,D> Collector<T,?,Map<K,D>> groupingBy( 
Function<? super T,? extends K> classifier, 
Collector<? super T,A,D> downstream) 


方法 签名 中 包含 了 部 分 Javadoc 注释 ， 其 中 了 为 集合 中 元 素 的 类 型 ，k 为 结果 映射 的 键 类 
型 ，A 为 累加 器 ，D 为 下 游 收集 器 的 类 型 ，? 表示 “未 知 "。 有 关 泛 型 在 Java 8 中 的 应 用 ， 
详细 信息 请 参见 附录 A。 
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Strean 接口 定义 的 部 分 方法 在 CoLLectors 类 中 存在 类 似 的 对 应 ， 它 们 的 对 比如 表 4-2 所 示 。 
表 4-2: Stream 接 口 定 义 的 方法 与 CoLLectors 类 定义 的 方法 








Stream Collectors 
count counting 

map mapping 

min minBy 

max maxBy 
IntStream.sum summingInt 
DoubleStream. sum summingDouble 
LongStream.sum summingLong 
IntStream.summarizing summarizingInt 
DoubleStream.summarizing summarizingDouble 
LongStream.summarizing summarizingLong 





需要 再 次 强调 的 是 ， 下 游 收集 器 用 于 对 上 游 操 作 (如 分 区 或 分 组 ) 产生 的 对 象 集合 进行 后 
期 处 理 。 





另 见 
有 关 应 用 下 游 收 集 器 确定 词典 中 最 长 单词 的 讨论 请 参见 范例 7.1， 有 关 partitioningBy 和 
groupingBy 方法 的 深入 讨论 请 参见 范例 4.5， 有 关 泛 型 的 详细 信息 请 参见 附录 A。 


4.7 查找 最 大 值 和 最 小 值 


问题 

用 户 希 望 确定 流 中 的 最 大 值 或 最 小 值 。 

方案 

既 可 以 使 用 Binary0perator 接口 定义 的 maxBy 和 minBy 方法 ， 也 可 以 使 用 Strean 接口 定义 
的 max 和 min 方法， 还 可 以 使 用 CoLLectors 类 定义 的 maxBy 和 minBy 方法 。 


讨论 

BinaryOperator 是 java.util.function 包 定 义 的 一 种 国 数 式 接口 ， 它 继承 自 BiFunction 接 
口 ， 适 合 在 函数 和 返回 值 的 参数 属于 同一 个 类 时 使 用 。 

BinaryOperator 接口 包括 两 种 静态 方法 : 


static <T> BinaryOperator<T> maxBy(Comparator<? super T> comparator) 
static <T> BinaryOperator<T> minBy(Comparator<? super T> comparator) 


两 种 方法 根据 所 提供 的 Comparator， 返 回 一 个 BinaryOperator。 
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我 们 以 一 个 Employee POJO 为 例 ， 讨 论 如 何 获 取 流 的 最 大 值 。 如 例 4-24 所 示 ，Employee 
POJO 包括 name、salary 与 department 这 三 个 特性 。 


例 4-24 Employee POJO 


public class Employee { 
private String name; 
private Integer salary; 
private String department; 





// 其 他 方法 


} 

List<Employee> employees = Arrays.asList( 0 
new Employee("Cersei", 250_000，"Lannister " ) ， 
new Employee("Jamie", 150_000, "Lannister")，, 
new Employee("Tyrion", 1_000, "Lannister"), 
new Employee("Tywin", 1_000_000, "Lannister"), 
new Employee("Jon Snow", 75_000, "Stark"), 
new Employee("Robb", 120_000, "Stark"), 
new Employee("Eddard", 125_000, "Stark")，, 
new Employee("Sansa", 0, "Stark"), 
new Employee("Arya", 1_000, "Stark")); 

Employee defaultEmployee = (2) 

new Employee("A man (or woman) has no name", 0, "Black and White"); 
@ 员工 集合 


@ 流 为 空 时 的 默认 值 

给 定 一 个 由 员工 构成 的 集合 ， 可 以 使 用 Stream.reduce 方法 ， 传 入 Binary0perator 作为 参 
数 。 例 4-25 展示 了 如 何 查 找 工资 最 高 的 员工 信息 。 
例 4-25 BinaryOperator .maxBy 方法 的 应 用 


Optional<Employee> optionalEmp = employees.stream() 
.reduce(BinaryOperator .maxBy(Comparator .comparingInt(Employee: :getSalary))); 


System.out.println("Emp with max salary: 
optionalEmp.orElse(defaultEmployee)); 


请 注意 ，reduce 方法 需要 传人 Binary0perator 作为 参数 。 静 态 方法 maxBy 根据 所 提供 的 
Comparator 生成 该 Binary0perator， 并 按 工资 高 低 对 员工 进行 比较 。 


述 方案 是 可 行 的 ， 不 过 采用 Stream.max 方法 其 实 更 简单 ， 该 方法 可 以 直接 应 用 于 流 : 
Optional<T> max(Comparator<? super T> comparator) 
例 4-26 显示 了 max 方法 的 应 用 。 
例 4-26 Stream.max 方法 的 应 用 


optionalEmp = employees.stream() 
.max(Comparator .comparingInt(Employee: :getSalary)); 


Stream.max 方法 与 Binary0perator .maxBy 方法 的 结果 并 无 不 同 。 


要 


























此 外 ， 几 种 基本 类 型 流 (IntStream、LongStrean 与 DoubleStream) 也 提供 一 个 不 传 入 任何 
参数 的 max 方法， 其 应 用 如 例 4-27 所 示 。 


例 4-27 查找 最 高 工资 
OptionalInt maxSalary = employees.stream() 
.mapToInt(Employee: :getSalary) 

.max(); 
System.out.println("The max salary is 


在 本 例 中 ，mapToInt 方 法 通过 调用 getsalary 方 法 将 员工 流转 换 为 整数 流 ， 并 返回 
IntStream。 之 后 ，Max 方法 返回 0ptionalInt。 


类 似 地 ，Collectors 工具 类 也 定义 了 一 种 称 为 maxBy 的 静态 方法 ， 可 以 直接 用 于 查找 最 
工资 ， 如 例 4-28 所 示 。 


例 4-28 Collectors.maxBy 方法 的 应 用 


optionalEmp = employees.stream() 
.COLLect(CoLLectors.maxBy(Comparator .comparingInt(Employee: :getSalary))); 


但 是 ，Collectors.maxBy 方法 不 便 处 理 ， 最 好 采用 Stream.max 方法 作为 替代 (如 例 4-27 所 
示 )。Collectors.maxBy 方法 在 用 作 下 游 收集 器 ( 即 对 分 组 或 分 区 操作 进行 后 期 处 理 ) 时 相 
当 有 用 。 例 4-29 通过 collectors.groupingBy 方法 创建 了 一 个 部 门 到 员工 列表 的 映射 ， 然 
后 计算 每 个 部 门 中 工资 最 高 的 员工 。 


例 4-29 ”Collectors.maxBy 用 作 下 游 收 集 器 


Map<String, Optional<Employee>> map = employees.stream() 
.COLLect(CoLLectors.groupingBy( 
Employee: :getDepartment, 
Collectors.maxBy( 
Comparator .comparingInt(Employee: :getSalary)))); 





+ maxSalary); 








型 




















map.forEach((house, emp) -> 
System.out.println(house + 


BinaryOperator .minBy 和 Collectors.minBy 方法 的 用 法 与 相应 的 maxBy 方法 类 似 。 


+ emp.orElse(defaultEmployee))); 


另 见 
有 关 Function 接口 的 讨论 请 参见 范例 2.4， 有 关 下 游 收集 器 的 讨论 请 参见 范例 4.6。 


4.8 创建 不 可 变 集合 


问题 
用 户 希 望 利用 Stream API 创建 不 可 变 的 列表 、 集 合 或 映射 。 
方案 


使 用 CoLLectors 类 新 增 的 静态 方法 coLLectingAndThen 。 
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讨论 

函数 式 编程 强调 并 行 (parallelization) 以 及 语义 的 清晰 ， 倾 向 于 尽 可 能 使 用 不 可 变 对 象 。 
Java 1.2 引入 了 集合 框架 ， 提 供 以 现 有 集合 为 基础 创建 不 可 变 集 合 的 各 种 方法 ， 但 使 用 起 
来 有 些 不 便 。 

Collections 工具 类 定义 了 unmodifiableList、unmodifiableSet 与 unmodifiabtLeMap 方法 
(以 及 其 他 以 unmodifiable 为 前 级 的 方法 )， 如 例 4-30 所 示 。 


例 4-30 ”Collections 类 定义 的 以 unmodifiable 为 前 级 的 方法 
static <T> List<T> unmodifiableList(List<? extends T> list) 
static <T> Set<T> unmodifiableSet(Set<? extends T> s) 
static <K,V> Map<K,V> unmodifiableMap(Map<? extends K,? extends V> m) 


三 种 方法 的 参数 分 别 为 现 有 的 列表 、 集 合 与 映射 。 结 果 列 表 、 合 与 映射 中 包含 的 元 
但 存在 一 个 重要 的 区 别 : JR 上 add 或 remove) 现 
在 都 能 抛 出 Unsupported0perationException。 


在 Java 8 之 前 ， 如 果 通 过 可 变 参 数列 表 获 取 到 单个 值 作为 参数 ， 则 会 生成 一 个 不 可 修改 的 
列表 或 集合 ， 如 例 4-31 所 示 。 


例 4-31 创建 不 可 修改 的 列表 或 集合 (Java 8 之 前 ) 
@SafeVvarargs ©@ 
public final <T> List<T> createImmutableListjJava7(T... elements) { 
return Collections.unmodifiableList(Arrays.asList(elements)); 



























































} 


@SafeVarargs © 
public final <T> Set<T> createImmutableSetJava7(T... elements) { 
return Collections.unmodifiableSet(new HashSet<>(Arrays.asList(elements))); 


} 
@ 用 户 承诺 不 会 破坏 输入 数组 类 型 。 详 见 附 录 A。 


两 段 代码 首先 传人 输入 值 ， 并 将 它们 转换 为 ist。 第 一 段 代 码 使 用 unmodifiableList 
包装 生成 的 列表 。 而 对 于 Set， 第 二 段 代 码 先 将 列表 用 作 集 合 构造 国 数 的 参数 ， 再 使 用 


unmodifiableSet, 


借 由 Java 8 引入 的 Stream API， 我 们 可 以 使 用 CoLLectors 类 定义 的 静态 方法 collectingAndThen， 
如 例 4-32 所 示 。 


例 4-32 创建 不 可 修改 的 列表 或 集合 (Java 8) 
import static java.util.stream.Collectors.collectingAndThen; 
import static java.util.stream.Collectors. toList; 
import static java.util.stream.Collectors.toSet; 

















// 采用 以 下 方法 来 定义 类 


@SafeVarargs 
public final <T> List<T> createImmutableList(T... elements) { 
return Arrays.stream(elements) 
.collect(collectingAndThen(toList(), 





Collections::unmodifiableList)); ©@ 


} 


@SafeVarargs 
public final <T> Set<T> createImmutableSet(T... elements) { 
return Arrays.stream(elements) 
.collect(collectingAndThen( toSet(), 
Collections: :unmodifiableSet)); © 


} 
©@ “终止 器 ”对 生成 的 集合 进行 包装 
collectingAndThen 方法 传 入 两 个 参数 ， 一 个 是 下 游 collector， 另 一 个 是 称 为 终止 器 


(finisher) 的 Function。 该 方法 的 作用 是 读 取 输 入 元 素 ， 并 将 它们 收集 到 List 或 set， 然 
后 利用 不 可 修改 的 函数 包装 结果 集合 。 


将 一 系列 输入 元 素 转换 为 一 个 不 可 修改 的 Map 看 起 来 并 不 直观 ， 部 分 原因 在 于 很 难看 出 哪 
些 输入 元 素 将 作为 键 ， 哪 些 将 作为 值 。 例 4-33* 采用 实例 初始 化 器 (instance initializer) ， 以 
一 种 很 别扭 的 方式 创建 了 一 个 不 可 变 的 Map。 


例 4-33 创建 不 可 变 的 Map 
Map<String, Integer> map = Collections.unmodifiableMap( 
new HashMap<String, Integer>() {{ 

put("have", 1); 
put("the", 2); 
put("high", 3); 
put("ground", 4); 

}}); 


熟悉 Java 9 的 读者 想必 已 经 了 解 ， 本 范例 中 的 所 有 问题 都 可 以 通过 工厂 方法 List.of、 
Set.of 与 Map.of 来 解决 ， 这 些 方法 能 极 大 提高 效率 。 














另 见 
Java 9 新 增 的 工厂 方法 能 自动 创建 不 可 变 集合 ， 相 关 讨 论 请 参见 范例 10.3。 


4.9 ”实现 CoLLector 接 口 


问题 
由 于 java.util.stream.Collectors 类 提供 的 工厂 方法 无 法 满足 需要 ， 用 户 希望 手动 实现 
java.util.stream.Collector 接口 。 


方案 
为 工厂 方法 Collector.of 传 入 的 supplier、accumulator、combiner、finisher 图 数 提供 
lambda 表达 式 或 方法 引用 ， 以 及 其 他 所 需 的 特性 。 
































注 4: 灵感 源 自 Carl Martensen 的 博文 “Java 9’s Immutable Collections Are Easier To Create But Use With Caution”。 
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讨论 

Collectors 工具 类 定义 了 多 种 便利 的 静态 方法 ， 它 们 的 返回 类 型 为 Collector 。 这 些 方法 包 
括 toList、toSet、toMap 以 及 toCollection， 相 关 讨 论 请 参见 其 他 音节。 实现 CoLLector 
的 类 的 实例 作为 Stream.collect 方法 的 参数 。 如 例 4-34 所 示 ，evenLengthstrings 方法 传 
入 字符 串 参 数 ， 并 返回 仅 包含 偶数 长 度 字 符 串 的 List。 


例 4-34 利用 collect 方法 返回 List 
public List<String> evenLengthStrings(String... strings) { 
return Stream.of(strings) 
.filter(s -> s.length() % 2 == 0) 
.COLLect(CoLLectors.toList()); © 








@ 将 偶数 长 度 的 字符 串 收 集 到 List 中 


编写 自 定 义 收集 器 的 过 程 则 略 显 复杂 。 收 集 器 使 用 5 个 函数 ， 它 们 的 作用 是 将 条 目 累 
加 到 可 变 容 器 ， 并 有 选择 性 地 对 结果 进行 转换 。 这 5 个 函数 是 supplier、accumulator、 


Combiner 、 A 以 及 characteristics。 


我 们 首先 讨论 characteristics 函数 ， 表 示 Collector .Characteristics 枚 举 的 一 个 不 可 变 
的 元 素 Set。 三 个 枚 举 常量 为 CONCURRENT、IDENTITY_FINISH 与 UNORDERED 。 CONCURRENT 表 
示 结 果 容 器 支持 多 个 线程 在 结果 容器 上 并 发 地 调用 累加 器 函数 ，UNORDERED 表示 集合 操作 
无 须 保留 元 素 的 出 现 顺序 (encounter order) ，IDENTITY_FINISH 表示 终止 器 函数 返回 其 参数 
而 不 做 任何 修改 。 


请 注意 ， 如 果 默 认 值 就 是 实际 需要 的 ， 则 不 必 提供 任何 特性 。 
下 面 列 出 了 每 种 参数 的 用 途 。 


supplier() 
吕 用 Supplier<A> 创建 累加 器 容器 (accumulator container) 。 




































































accumulator() 
使 用 BiConsumer<A,T> 为 累加 器 容器 添加 一 个 新 的 数据 元 素 。 


combiner() 
使 用 Binary0perator<A> 合并 两 个 累加 器 容器 。 


finisher() 
使 用 Function<A,R> 将 累加 器 容器 转换 为 结果 容器 。 


characteristics() 
从 枚 举 值 中 选择 的 Set<Collector.Characteristics>。 


如 果 读 者 熟悉 java.util.function 包 定义 的 国 数 式 接口 ， 则 不 难 理解 各 个 参数 的 含义 
Supplier 用 于 创建 累加 临时 结果 所 用 的 容器 ，BiCconsumer 用 于 将 一 个 元 素 肖 ee 
BinaryOperator 到 从 入 类 型 和 给 由 关 型 本 因此 可 以 将 两 个 累加 器 合 二 为 一 
Function 将 累加 器 转换 为 所 需 的 结果 容器 。 










































































程序 在 收集 过 程 中 调用 上 述 方法 ， 它 们 由 Stream.collect 这 样 的 方法 触发 。 从 概念 上 讲 ， 








集合 过 程 相当 于 例 4-35 所 示 的 ( 泛 型 ) 代码 ( 取 自 Javadoc ) 。 
例 4-35 各 种 CoLLector 方法 的 用 法 


R container = COLLector .suppLier .get(); 0 
for (Tt : data) { 
collector .accumulator().accept(container, t); @ 





} 


return collector.finisher().apply(container); 【3) 
@ 创建 里 加 器 容器 
@ 将 每 个 元 素 添 加 到 累加 器 容器 
@ 通过 finisher 函数 将 累加 器 容器 转换 为 结果 容器 





本 例 并 未 出 现 combiner 函数 ， 这 或 许 令 人 感到 困惑 。 如 果 处 理 的 是 顺序 流 ， 则 不 需要 该 函 
数 ， 算 法 将 既定 方式 执行 。 0 流 将 被 分 为 多 个 子 流 ， 每 个 子 流 都 会 生 














成 各 自 的 累加 器 容器 。 接 下 来 ， 在 连接 过 程 中 使 用 combiner 函数 将 多 个 累加 器 容器 合 
一 个 ， 然 后 应 用 finisher 函数 。 

例 4-36 显示 了 与 例 4-34 类 似 的 代码 。 

例 4-36 利用 collect 方法 返回 不 可 修改 的 SortedSet 


public SortedSet<String> oddLengthStringSet(String... strings) { 
Collector<String, ?, SortedSet<String>> intoSet = 








Collector .of(TreeSet<String>: :new, 0 
SortedSet: :add, © 
(left, right) -> { © 


left.addAll(right); 
return left; 
}， 
Collections: :unmodifiableSortedSet); @ 
return Stream.of(strings) 
.filter(s -> s.length() % 2 != 0) 
.collect(intoSet); 


} 
@ Supplier: 创建 新 的 TreeSet 
@ BiConsumer: 将 每 个 字符 串 添加 到 TreeSet 
@ Binary0perator: 将 两 个 SortedSet 实例 合 二 为 一 
@ finisher: 创建 不 可 修改 的 Set 
程序 将 输出 一 个 经 过 排序 且 不 可 修改 的 字符 串 集 ， 它 按 字典 序 排序 
本 例 展示 了 如 何 通过 CoLLector .of 方法 生成 收集 器 。of 方法 包括 以 下 两 种 形式 ; 


static <T,A,R> Collector<T,A,R> of(Supplier<A> supplier, 
BiConsumer<A,T> accumulator, 
BinaryOperator<A> combiner, 
Function<A,R> finisher, 
Collector.Characteristics... characteristics) 
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static <T,R> Collector<T,R,R> of(Supplier<R> supplier, 
BiConsumer<R,T> accumulator, 
BinaryOperator<R> combiner, 
Collector.Characteristics... characteristics) 


Collectors 类 提供 了 多 种 用 于 生成 收集 器 的 便利 方法 ， 用 户 几乎 不 需要 创建 自 定义 收集 
器 ， 不 过 掌握 相关 的 知识 仍然 很 有 必要 。 综 合 应 用 java.util.function 包 定 义 的 函数 式 接 
口 ， 可 以 创建 各 种 有 趣 的 对 象 。 








另 见 
有 关 finisher 函数 (一 种 下 游 收 集 器 ) 的 详细 讨论 请 参见 范例 4.6， 有 关 Supplier、 


Function、BinaryOperator 等 国 数 式 接 口 的 讨论 请 参见 第 2 章 ， 有 关 Collectors 类 定义 的 
各 种 静态 工具 方法 请 参见 范例 4.2。 





第 5 章 





流 式 操作 、lambda 表 达 式 与 方法 
引用 的 相关 问题 





前 几 章 介绍 了 lambda 表达 式 和 方法 引用 的 基础 知识 ， 并 讨论 了 它们 在 流 中 的 应 用 ， 然 而 








在 实际 开发 中 可 能 会 遇 到 一 些 问 题 。 例 如 ， 既 然 接 口 提供 默认 方法 ， 那 么 当 一 个 类 实现 了 





具有 相同 默认 方法 签名 、 但 具有 不 同 实现 的 多 个 接口 时 会 出 现 什 么 情况 呢 ? 能 否 在 lambda 








表达 式 内 部 编写 代码 ， 但 尝试 访问 或 修改 在 其 外 部 定义 的 变量 呢 ?” 当 无 法 为 方法 签名 添加 

















throws 子 句 上 时， 如 何在 lambda 表达 式 中 处 理 异常 呢 ? 


这 一 章 将 讨论 上 述 问题 。 














5.1 java.util.0bjects 类 


问题 








方案 

















使 用 Java 7 引入 的 java.util.0bjects 类 ， 它 在 流 处 理 








用 户 希 望 使 用 静态 工具 方法 实现 非 空 验证 、 比 较 等 操作 。 


中 相当 有 用 。 





讨论 


Java 7 引入 的 0bjects 类 是 一 种 不 其 知名 的 类 ， 它 定义 了 处 理 各 种 任务 所 需 的 静态 方法 。 
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static boolean deepEquals(Object a, Object b) 
验证 两 个 数组 是 否 深层 相等 (deep equality) ， 该 方法 在 数组 比较 中 尤其 有 用 。 
static boolean equaLs(Object a, Object b) 


验证 两 个 参数 是 否 彼此 相等 ， 它 是 空 安全 (null safe) 的 。 


static int hash(Object... values) 
为 输入 值 序列 生成 散 列 码 (hash code)。 


static String toString(Object o) 
如 果 参 数 不 为 nutl 则 返回 调用 tostring 的 结果 ， 否 则 返回 null。 


static String toString(Object o, String nullDefault) 
如 果 第 一 个 参数 不 为 null， 返 回调 用 tostring 的 结果 ， 如 果 第 一 个 参数 为 null， 返 回 
第 二 个 个 参数 。 


此 外 ， 可 以 通过 requireNonNull 方法 的 各 种 重 载 形式 来 验证 参数 。 


static <T> T requireNonNull(T obj) 
如 果 参 数 不 为 nuLL 则 返回 T， 否 则 抛 出 NullPointerException。 
static <T> T requireNonNULL(T obj, String message) 
与 上 一 个 方法 相同 ， 但 由 于 参数 为 null 而 抛 出 的 NullPointerException 将 显示 指定 的 
消息 。 
static <T> T requireNonNull(T obj, Supplier<String> messageSupplier) 
与 上 一 个 方法 相同 ， 但 如 果 第 一 个 参数 为 mull， 则 调用 给 定 的 Supplier 为 
NullPointerException 生成 消息 。 
可 以 看 到 ， 最 后 一 个 方法 传人 SuppLier<String> 作为 参数 ， 这 也 是 为 什么 本 书 会 讨论 
Objects 类 的 原因 。 不 过 ， 更 有 说 服 力 的 原因 在 于 Java 8 为 0bjects 类 引入 的 isNuLL 和 
nonNull 方法 ， 二 者 返回 布尔 值 。 
static boolean isNull(Object obj) 
如 果 提 供 的 引用 为 nutl 则 返回 true， 否 则 返回 false。 


static boolean nonNull(Object obj) 
如 果 提 供 的 引用 不 为 nutLtL 则 返回 true， 否 则 返回 false。 


上 述 方法 的 优点 在 于 ， 它 们 可 以 用 作 筛 选 器 的 Predicate 实例 。 


我 们 以 返回 集合 的 类 为 例 进行 说 明 。 例 5-1 定义 了 两 个 方法 ,分 别 返 回 完整 的 集合 (无论 
集合 的 性 质 如 何 ) 与 滤 掉 空 元 素 的 集合 。 
例 5-1 返回 集合 与 滤 掉 空 元 素 


List<String> strings = Arrays.asList( 
"this", null, "is", "a", null, "list", "of", "strings", null); 














































































































List<String> nonNullStrings = strings.stream() 
.filter(Objects: :nonNull) 0 
.collect(Collectors.toList()); 





@ 小 掉 空 元 素 
如 例 5-2 所 示 ， 可 以 使 用 0bjects.deepEquals 方法 进行 测试 。 
例 5-2 ”筛选 器 测试 


QTest 
public void testNonNulls() throws Exception { 
List<String> strings = 
Arrays.asList("this", "is", "a", "list", "of", "strings"); 
assertTrue(Objects.deepEquals(strings, nonNullStrings); 


} 


我 们 将 上 述 过 程 一 般 化 ， 使 之 不 仅 适 用 于 字符 串 。 例 5-3 所 示 的 代码 可 以 从 任何 列表 中 滤 
掉 空 元 素 。 
例 5-3 从 泛 型 列表 (generic list) 中 滤 掉 空 元 素 


public <T> List<T> getNonNullElements(List<T> list) { 
return list.stream() 
.filter(Objects: :nonNull) 
.collect(Collectors. toList()); 








} 


可 以 看 到 ， 对 于 一 个 生成 List (其 中 多 个 元 素 为 空 ) 的 方法 ,通过 上 述 代 码 滤 掉 其 中 的 空 
元 素 并 非 难事 。 


5.2 lambda 表 达 式 与 效果 等 同 于 final 的 变量 
问题 


用 户 希 望 从 lambda 表达 式 内 部 访问 在 其 外 部 定义 的 变量 。 

方案 

必须 将 在 lambda 表达 式 内 部 访问 的 局 部 变量 声明 为 final， 或 使 其 具备 等 同 于 final 的 效 
果 (effectively final) 。 可 以 对 特性 (attribute) 进行 访问 和 修改 。 


讨论 

20 世纪 90 年 代 末 ， 在 Java 初 登 舞 台 时 ， 开 发 人 员 偶尔 会 使 用 GUI 库 Swing 来 编写 客户 
端 ay 应 用 程序 。 与 所 有 GUI 库 一 样 ，Swing 组 件 也 是 事件 驱动 的 。 换 言 之 ,组件 产 生 事 
件 ， 监 听 器 (listener) 对 事件 做 出 响应 。 


为 每 个 组 件 创 建 单独 的 监听 器 被 视 为 一 种 良好 实践 ， 因 此 监听 器 通常 作为 匿名 内 部 类 实 
现 。 使 用 内 部 类 不 仅 有 助 于 保持 程序 的 模块 化 ， 内 部 类 中 的 代码 还 可 以 访问 并 修改 外 部 类 
的 私有 特性 。 例 如 ，JButton 实例 生成 ActionEvent， 而 ActionListener 接口 包含 一 个 名 为 































































































注 1: 一 种 基于 Java 的 跨 平台 MVC 框架 ， 采 用 单线 程 模型 ， 属 于 JFC 的 一 部 分 。 一 一 译 者 注 
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actionPerformed 的 单一 抽象 方法 。 一 旦 实现 被 注册 为 监听 器 ， 就 会 调用 该 方法 。 相 关 示 例 
如 例 5-4 所 示 。 


例 5-4 简单 的 Swing GUI 
public class MyGUI extends ]JFrame { 
private JTextFieLd name = new JTextField("Please enter your name"); 
private JTrextField response = new JTextField("Greeting"); 
private JButton button = new JButton("Say Hi"); 





public MyGUI() { 
// 无 关 的 GUI 设置 代码 


String greeting = "Hello, %s!"; 0 
button.addActionListener(new ActionListener() { 
@Override 


public void actionperformed(ActionEvent e) { 
response.setText( 
String.format(greeting, name.getText()); @ 


// greeting = "Anything else"; (3 
} 
}); 
} 
} 
@ 局 部 变量 
@ 访问 局 部 变量 和 特性 


变 
@ 修改 局 部 变量 (无 法 编译 ) 

在 本 例 中 ，greeting 字符 串 是 在 构造 函数 内 部 定义 的 局 部 变量 ，name 和 response 变量 是 类 
的 特性 ，ActionListener 接口 以 匿名 内 部 类 的 形式 实现 ， 其 中 一 个 方法 为 actionPerformed。 
请 注意 ， 内 部 类 中 的 代码 : 


。 可 以 访问 特性 (如 name 和 response) 

。 可 以 修改 特性 (本 例 没 有 展示 ) 

。 可 以 访问 局 部 变量 (greeting) 

。 无 法 修改 局 部 变量 

在 Java 8 之前， 编译 器 要 求 greeting 变量 被 声明 为 final。 而 在 Java 8 中 ， 变 量 不 必 采 用 
final 修饰 ， 但 必须 具备 等 同 于 finalt 的 效果 。 换 言 之 ， 任 何 试图 修改 局 部 变量 值 的 代码 
都 不 会 被 编译 。 

当然 ， 在 Java 8 中 ， 应 采用 lambda 表达 式 替 换 匿 名 内 部 类 ， 如 例 5-5 所 示 。 

例 5-5 监听 器 的 lambda 表达 式 


String greeting = "Hello, %s!"; 
button.addActionListener(e -> 
response.setText(String.format(greeting,name.getText()))); 


同样 地 ，greeting 变量 不 必 被 声明 为 final， 但 必须 具备 等 同 于 final 的 效果 ， 否 则 代码 
无 法 编译 。 
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如 果 读 者 对 Swing 示例 不 感 兴趣 ， 我 们 再 来 讨论 另外 一 个 示例 。 如 例 5-6 所 示 ， 我 们 希望 
对 给 定 List 中 的 所 有 值 求 和 。 


例 5-6 对 List 中 的 所 有 值 求 和 


List<Integer> nums = Arrays.asList(3, 1, 4, 1, 5, 9); 


int total = 0; 0 

for (int n : nums) { @ 
total += nN; 

} 

total = 0; 

nums.forEach(n -> total += nN); © 


total = nums.stream() 
.mapToInt(Integer::vaLueOf) 
.Sum() 


@ 局 部 变量 total 

@ 传统 的 for-each 循环 

@ 修改 lambda 表达 式 中 的 局 部 变量 (无 法 编译 ) 

@ 将 流转 换 为 Intstreanm 并 调用 sun 方法 

上 述 代 码 声 明了 一 个 名 为 total 的 局 部 变量 ， 并 采用 传统 的 for-each 循环 对 所 有 值 求 和 。 


Iterable 接口 定义 的 forEach 方法 传 入 Consumer 作为 参数 。 如 果 Consumer 试图 修改 total 
变量 ， 则 代码 不 会 编译 。 


当然 ， 解 决 这 个 问题 的 正确 方式 是 将 流转 换 为 Intstream。 由 于 它 定义 了 sum 方法， 不 会 
涉及 任何 局 部 变量 。 

严格 来 说 ， 函 数 以 及 在 其 环境 中 定义 的 可 访问 变量 称 为 闭 包 (closure)。 从 这 一 定义 来 看 ， 
Java 对 局 部 变量 的 处 理 并 不 是 很 明确 : 虽然 可 以 访问 局 部 变量 ， 但 无 法 修改 。 在 Java 8 
中 ，lambda 表达 式 是 通过 值 (而 非 变 量 ) 来 关闭 的 ， 读 者 或 许 认 为 lambda 表达 式 实际 上 
属于 闭 包 ”。 






































另 见 
其 他 语言 对 闭 包 变量 (closure variable) 的 处 理 有 所 不 同 。 例 如 ，Groovy 允许 对 闭 包 变量 
进行 修改 ,但 通常 不 认为 这 是 一 种 良好 实践 。 











注 2: 那么 ， 为 什么 不 将 Java 8 引入 的 lambda 表达 式 称 为 闭 包 呢 ?根据 Bruce Eckel 的 说 法 ， 原 因 在 于 “ 闭 
包 ” 这 个 术语 的 应 用 过 于 频繁 ， 因 而 引发 了 和 争议 。“ 当 人 们 讨论 真正 的 闭 包 时 ， 往 往 意味 着 他 们 在 讨 
论 第 一 种 语言 遇 到 的 闭 包 ”。 感 兴趣 的 读者 可 以 参考 Bruce 的 博文 “Are Java 8 Lambdas Closures?”。 
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5.3 随机 数 流 


问题 
用 户 希望 在 指定 范围 内 生成 整 型 、 长 整 型 或 双 精 度 随 机 数 流 。 


方案 


使 用 java.util.Randonm 类 定义 的 ints、Longs 与 doubles 方法 。 


讨论 

如 果 仅 需要 生成 一 个 双 精 度 随 机 数 ， 则 不 妨 采 用 静态 Math.randon 方法 ， 它 返回 一 个 
位 于 0.0 和 1.0 之 间 的 双 精 度 值 *。 这 个 过 程 相当 于 将 java.util.Random | 化 并 调用 
nextDouble 方法 。 

Random 类 定义 了 一 个 用 于 指定 随机 种 子 的 构造 函数 。 指 定 的 种 子 相 同 ， 生 成 的 随机 数 序 列 
也 相同 ， 这 在 测试 中 相当 有 用 。 

如 果 需 要 生成 随机 数 顺 序 流 ， 可 以 使 用 Randonm 类 引入 的 ints、Longs 与 doubles 方法 ， 
者 的 签名 如 下 (未 显示 相应 的 重 载 形 式 ) : 


IntStream ints() 
LongStream longs() 
DoubleStream doubles() 


借 由 三 种 方法 的 重 载 形式 ， 我 们 可 以 指定 结果 流 的 大 小 以 及 生成 数 的 最 小 值 和 最 大 值 。 以 
doubles 方法 为 例 : 


DoubleStream doubles(long streamSize, double randomNumberOrigin, 
double randomNumberBound) 


返回 流 生 成 给 定数 量 (streamSize) 的 双 精 度 伪 随 机 数 ， 每 个 数 大 于 或 等 于 randomNumberOrigin， 
且 严 格 小 于 randomNumberBound。 

如 果 未 指定 streansize, 方法 将 返回 一 个 所 谓 的 “有 效 无 限 流 ”(effectively unlimited stream) “。 
如 果 不 指定 最 小 值 或 最 大 值 ， 对 于 doubles 方法 ， 最 小 值 默认 为 0， 最 大 值 默 认为 1， 对 
于 ints 方法 ， 最 小 值 和 最 大 值 默 认为 整 型 数据 的 完整 范围 ， 对 于 tlongs 方法 ， 最 小 值 和 最 
大 值 默认 为 长 整 型 数据 的 《有 效 ) 完整 范围 。 就 上 述 三 种 情况 而 言 ， 结 果 相 当 于 重复 调用 


nextDouble、nextInt 与 nextLong 。 
示例 代码 如 例 5-7 所 示 。 
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注 3: 根据 Javadoc 的 描述 ， 返 回 值 在 指定 范围 内 是 “ 伪 随 机 且 (近似 ) 均匀 分 布 的 ”(pseudorandomly with 
(approximately) uniform distribution) 。 这 表明 ， 在 讨论 随机 数 生 成 器 时 必须 做 好 两 手 准 备 。 
注 4: 可 以 将 流 视 为 无 限 ， 但 从 技术 上 讲 它 是 有 限 的 。 这 里 的 “无 限 ” 相 当 于 Long.MAX_VALUE。 一 一 译 者 注 












































例 5-7 生成 随机 数 流 

Random r = new Random(); 
.ints(5) 0 
.Sorted() 
.forEach(System.out::printLn); 


一 


一 


.doubles(5, 0, 0.5) @ 
.Sorted() 
.forEach(System.out: :println); 


List<Long> Longs = r.Longs(5) 
.boxed() 【3) 
.collect(Collectors. toList()); 
System.out.printLn(Longs ) ; 


List<Integer> listOfInts = r.ints(5, 10, 20) 
.collect(LinkedList::new, LinkedList::add, LinkedList::addAll); @ 
System.out.printLn(ListOfInts ); 


@ 五 个 随机 整数 

@ 五 个 位 于 0 (包括 ) 和 0.5 (不 包括 ) 之 间 的 双 精 度 随 机 数 

@ 将 Long 装 箱 为 Long 以 便 收 集 

@ 使 用 collect 而 非 调用 boxed 

如 果 在 创建 基本 数据 类 型 集合 时 遇 到 问题 ， 后 两 个 代码 段 给 出 了 解决 方案 。 我 们 无 法 对 基 
本 数据 类 型 集合 调用 coLLect(CoLLectors.toList())， 相 关 讨论 请 参见 范例 3.2。 该 范例 建 
议 ， 既 可 以 通过 boxed 方法 将 Long 型 数据 转换 为 Long 的 实例 ， 也 可 以 使 用 collect 方法 
的 三 参数 形式 并 自行 指定 Supplier、 累 加 器 与 组 合 器 。 

值得 注意 的 是 ，SecureRandom 属于 Randon 的 子 类 ， 它 提供 一 个 加 密 的 强 随 机 数 生成 


Bi 


器 (cryptographically strong random number generator)。Random 类 定义 的 ints、longs 与 
doubles 方法 (以 及 它们 的 重 载 形式 ) 同样 适用 于 SecureRandon 类 ， 区 别 仅 在 于 所 用 的 生 
成 器 不 同 。 




















另 见 
有 关 boxed 方法 在 Strean 中 的 应 用 请 参见 范例 3.2。 


5.4 Map 接口 的 默认 方法 


问题 
如 果 Map 中 包含 元 素 ， 用 户 希 望 赫 换 元 素 ， 如 果 Map 中 没有 元 素 ， 用 户 希 望 添加 元 素 ; 此 
外 ， 用 户 还 希望 执行 其 他 相关 操作 。 
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使 用 java.util.Map 接口 新 增 的 各 种 默认 方法 ， 如 computeIfAbsent、computeIfPresent、 
replace、merge 等 。 


讨论 

从 Java 1.2 引入 集合 框架 (collections framework) 起 ，Map 接口 就 已 存在 。Java 8 为 Map 接 
口 引 [入 了 一 些 新 的 默认 方法 ， 如 表 5-1 所 示 。 

表 5-1: Map 接 口 定义 的 默认 方法 











































































































方法 描述 

Compute 根据 现 有 的 键 和 值 计 算 新 的 值 

computeIfAbsent 如 果 键 存在 ， 返 回 对 应 的 值 ， 否 则 通过 提供 的 函数 计算 新 的 值 并 保存 
computeIfPresent 计算 新 的 值 以 替换 现 有 的 值 

forEach 对 Map 进行 迭代 ， 将 所 有 键 和 值 传递 给 Consumer 

getOrDefault 如 果 键 在 Map 中 存在 ， 返 回 对 应 的 值 ， 否 则 返回 默认 值 

merge 如 果 键 在 Map 中 不 存在 ， 返 回 提供 的 值 ， 否 则 计算 新 的 值 
putIfAbsent 如 果 键 在 Map 中 不 存在 ， 将 其 关联 到 给 定 的 值 

remove 如 果 键 的 值 与 给 定 的 值 匹配 ， 删 除 该 键 的 条 目 

replace 将 现 有 键 的 值 替 换 为 新 的 值 

repLaceALL 将 Map 中 每 个 条 目的 值 替 换 为 对 当前 条 目 调用 给 定 函 数 后 的 结果 








Java 8 为 已 有 十 多 年 历史 的 Map 接口 引入 了 不 少 新 方法 ， 某 些 方法 能 为 开发 提供 极 大 的 便利 。 
1. computeIfAbsent 
computeIfAbsent 方法 的 完整 签名 如 下 : 

V computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction) 
在 创建 方法 调用 结果 的 缓存 时 ，computeIfAbsent 尤其 有 用 。 我 们 以 经 典 的 斐 波 那 契 数 递归 
计算 为 例 进行 讨论 。 如 例 5-8 所 示 , 任何 大 于 1 的 斐 波 那 契 数 等 于 前 两 个 辈 波 那 契 数 之 和 >。 
例 5-8 斐 波 那 契 数 递归 计算 

Long fib(Long i) { 

if (i == 0) return 0; 


if (i == 1) return 1; 
return fib(i - 1) + fib(i - 2); @ 














} 
@ 效率 极 低 
上 述 代码 的 问题 在 于 需要 进行 大 量 重复 的 计算 (如 fib(5) = fib(4) + fib(3) = fib(3) + 
fib(2) + fib(2) +fib(1) = ...)， 导 致 程序 效率 极 低 。 可 以 利用 缓存 解决 这 个 问题 ， 函 
数 式 编程 将 这 种 技术 称 为 记忆 化 (memoization)。 如 例 5-9 所 示 ， 我 们 将 结果 修改 为 存储 
BigInteger 实例 。 











注 5: 大 部 分 读者 想必 都 听 过 这 个 笑话 :“ 据 说 今年 的 斐 波 那 契 会 议 将 和 前 两 年 一 样 好 。 
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例 5-9 利用 缓存 计算 斐 波 那 契 数 
private Map<Long, BigInteger> cache = new HashMap<>(); 
public BigInteger fib(long i) { 
if (i == 0) return BigInteger .ZERO; 
if (i == 1) return BigInteger .ONE; 


return cache.computeIfAbsent(i, n -> fib(n - 2).add(fib(n - 1))); © 











@ 如 果 键 的 值 在 缓存 中 存在 ， 返 回 对 应 的 值 ， 否 则 计算 新 的 值 并 保存 


本 例 采 用 缓存 计算 斐 波 那 契 数 ， 其 中 键 为 提供 的 数字 ， 值 为 相应 的 辈 波 那 契 数 。 
computeIfAbsent 方法 在 缓存 中 搜索 给 定 的 数字 ， 存 在 则 返回 对 应 的 值 ， 否 则 使 用 提供 的 
Function 计算 新 的 值 ， 将 其 保存 在 缓存 中 并 返回 。 对 单一 方法 而 言 ， 这 已 是 很 大 的 改进 。 
2. computeIfPresent 
computeIfPresent 方法 的 完整 签名 如 下 : 

V computeIfPresent(K key, 

BiFunction<? super K, ? super V, ? extends V> remappingFunction) 

仅 当 与 某 个 值 关 联 的 键 在 Map 中 存在 时 ，computeIfPresent 才 会 更 新 该 值 。 假 设 我 们 需要 
解析 一 个 文本 ， 并 计算 文本 中 每 个 单词 的 出 现 次 数 。 这 种 一 致 性 (concordance) 计算 在 实 
际 中 并 不 鲜 见 。 如 果 仅 对 某 些 特定 单词 感 兴 趣 ， 可 以 使 用 computeIfPresent 方法 进行 更 
新 ， 如 例 5-10 所 示 。 
例 5-10 ” 仅 更 新 特定 单词 的 出 现 次 数 


public Map<String,Integer> countWords(String passage, String... strings) { 
Map<String, Integer> wordCounts = new HashMap<>(); 






















































































Arrays.stream(strings).forEach(s -> wordCounts.put(s, 0)); © 


Arrays.stream(passage.split(" ")).forEach(word -> @ 
wordCounts .computeIfPpresent(word, (key, val) -> val + 1)); 


return wordCounts; 


@ 将 特定 单词 置 于 映射 中 ， 并 将 计数 器 设置 为 0 

@ 读 取 文 本 ， 仅 更 新 特定 单词 的 出 现 次 数 

通过 将 特定 单词 置 于 映射 中 并 将 初始 计数 器 设置 为 0， 就 能 让 computeIfpPresent 方法 只 更 
新 这 些 值 。 

如 例 5-11 所 示 ， 对 一 段 文 本 以 及 一 个 逗号 分 隔 的 单词 列表 执行 上 述 程序 ， 可 以 得 到 所 需 的 
结果 。 

例 5-11 调用 countwords 方法 


String passage = "NSA agent walks into a bar. Bartender says, "+ 
"'Hey, I have a new joke for you.' NSA agent says, 'heard it'."; 
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Map<String, Integer> counts = demo.countWords(passage, "NSA", "agent", "joke"); 
counts.forEach((word, count) -> System.out.println(word + "=" + count)); 





// 输出 为 : NSA=2，agent=2，joke=1 
可 以 看 到 ， 仅 当 所 需 单词 是 映射 中 的 键 时 ， 程 序 才 会 更 新 它们 的 出 现 次 数 。 与 之 前 一 样 
采用 Map 接口 定义 的 默认 方法 forEach 打印 值 ， 该 方法 传人 BtConsumer ， 其 参数 为 键 和 值 。 
3. 其 他 方法 
replace 方法 的 用 法 与 put 方法 类 似 ， 前 提 是 键 已 经 存在 。 如 果 键 不 存在 ，reptLace 不 会 执 
行 任何 操作 ， 而 put 将 添加 一 个 空 键 (null key)， 不 过 这 可 能 并 非 如 我 们 所 愿 。 
replace 方法 包括 两 种 重 载 形式 .: 


V replace(K key, V value) 
boolean replace(K key, V oldValue, V newValue) 


对 于 第 一 种 形式 ， 如 果 键 在 映射 中 存在 ， 则 将 其 奉 换 为 对 应 的 值 ， 对 于 第 二 种 形式 ， 如 有 果 
键 的 值 与 指定 的 值 相等 ， 则 将 其 替换 为 新 的 值 。 


使 用 不 存在 的 键 调用 Map 接口 的 get 方法 将 返回 nutll， 这 个 令 人 头疼 的 问题 可 以 通过 
getOrDefault 方法 解决 。 该 方法 仅 返 回 默认 值 ， 但 不 会 将 键 添加 到 映射 中 。 


getOrDefault 方法 的 签名 如 下 : 


V getOrDefault(Object key, V defaultValue) 









































如 果 键 在 映射 中 不 存在 ，getorDefault 方法 将 返回 默认 值 ， 但 不 会 将 这 个 键 
添加 到 映射 中 。 








merge 方法 非常 有 用 ， 其 完整 签名 如 下 : 


V merge(K key, V value, 
BiFunction<? super V, ? super V, ? extends V> remappingFunction) 


对 于 一 段 给 定 的 文本 ， 假 设 我 们 希望 统计 所 有 单词 〈 而 不 仅 是 特定 单词 ) 的 出 现 次 数 ， 那 
么 通常 需要 考虑 两 种 情况 ， 如 果 单词 已 经 在 映射 中 ， 则 更 新 计数 器 ， 如 果 单 词 不 在 映射 中 ， 
则 将 其 置 于 映射 中 并 使 计数 器 加 1。 可 以 通过 merge 方法 简化 这 个 过 程 ， 如 例 5-12 所 示 。 


例 5-12 merge 方法 的 应 用 
public Map<String, Integer> fullWordCounts(String passage) { 
Map<String, Integer> wordCounts = new HashMap<>(); 
String testString = passage.toLowerCase().replaceAll("\\W"," "); © 





Arrays.stream(testString.split("\\s+")).forEach(word -> 
wordCounts.merge(word, 1, Integer::suym)); @ 


return wordCounts; 
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@ 将 字符 串 转 换 为 小 写字 母 并 删除 标点 符号 

@ 更 新 给 定单 词 的 计数 器 

merge 方法 传人 键 和 默认 值 。 如 果 键 在 映射 中 不 存在 ， 则 插入 默认 值 ， 否 则 根据 原 有 值 并 
使 用 BinaryOperator (本 例 为 Integer: :sum) 计算 出 新 的 值 。 

本 范例 讨论 了 Map 接口 新 增 的 默认 方法 ， 希 望 这 些 方法 能 为 程序 开发 带 来 便利 。 


5.5 ”默认 方法 冲突 


问题 

一 个 类 实现 了 两 个 接口 ， 每 个 接口 包含 的 默认 方法 相同 ， 但 实现 不 同 。 

方案 

在 类 中 实现 方法 。 借 由 关键 字 super， 实 现 仍然 可 以 使 用 接口 提供 的 默认 方法 。 

讨论 

Java 8 支持 在 接口 中 使 用 静态 和 默认 方法 。 默 认 方 法 提供 由 类 继承 的 实现 ， 这 使 得 接口 可 
以 在 不 破坏 现 有 类 实现 的 情况 下 添加 新 的 方法 。 


由 于 一 个 类 可 以 实现 多 个 接口 ， 它 既 可 能 继承 具有 相同 签名 但 实现 不 同 的 默认 方法 ， 也 可 
能 已 包含 自己 的 默认 方法 。 
此 时 需要 考虑 以 下 三 种 情况 。 
。 如 果 类 的 方法 和 接口 的 默认 方法 发 生 冲突 ， 则 类 的 方法 始终 优先 。 
。 如 果 两 个 接口 〈 其 中 一 个 接口 是 另 一 个 的 后 代 ) 发 生 冲 突 ， 则 后 代 接 口 优先 ， 如 果 两 个 
类 (其 中 一 个 类 是 另 一 个 的 后 代 ) 发 生 冲 突 ， 则 后 代 类 优先 。 
。 如 果 两 个 默认 方法 之 间 不 存在 继承 关系 ， 则 类 无 法 编译 。 
对 于 第 三 种 情况 ， 只 需 在 类 中 实现 方法 即 可 ， 第 三 种 情况 将 简化 为 第 一 种 情况 。 
观察 例 5-13 所 示 的 Company 接口 和 例 5-14 所 示 的 Employee 接口 。 
例 5-13 包含 默认 方法 的 Company 接口 
public interface Company { 
default String getName() { 


return "Initech"; 


} 
// 其 他 方法 

































































} 
关键 字 default 将 getName 方法 指定 为 默认 方法 ， 它 提供 一 个 返回 企业 名 称 的 实现 。 
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例 5-14 包含 默认 方法 的 Employee 接口 
public interface Employee { 
String getFirst(); 


String getLast(); 
void convertCaffeineToCodeForMoney(); 


default String getName() { 
return String.format("%s %s", getFirst(), getLast()); 


} 
} 


Employee 接口 同样 定义 了 一 个 名 为 getName 的 默认 方法 ， 其 签名 与 Company 接口 中 的 getName 
方法 相同 ， 但 二 者 的 实现 不 同 。 如 例 5-15 所 示 ，CompanyEmployee 类 实现 了 Company 和 
Employee 两 个 接口 ， 从 而 导致 冲突 。 


例 5-15 最 初 的 CompanyEmployee 类 (无 法 编译 ) 
public class CompanyEmployee implements Company, Employee { 
private String first; 
private String last; 








@Override 
public void convertCaffeineToCodeForMoney() { 
System.out.println("Coding..."); 


} 


@Override 
public String getFirst() { 
return first; 


} 


@Override 
Public String getLast() { 
return last; 
} 
} 


由 于 CompanyEmployee 类 继承 了 与 getName 无 关 的 默认 方法 ， 它 无 法 编译 。 为 解决 这 个 问题 ， 
需要 在 CompanyEmployee 类 中 添加 用 户 自 定义 的 getName 方法 ， 它 将 重 写 两 个 默认 方法 。 


不 过 ， 借 由 关键 字 super， 仍 然 可 以 使 用 所 提供 的 默认 方法 ， 如 例 5-16 所 示 。 
例 5-16 调整 后 的 CompanyEmployee 类 


public class CompanyEmployee implements Company, Employee { 


























@Override 
public String getName() { @ 
return String.format("%s working for %s", 
Employee.super .getName(), Company.super.getName()); @ 
} 





// 其 余 代码 和 之 前 一 样 


~ 








大 
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@ 实现 getName 方法 

@ 通过 super 访问 默认 实现 

可 以 看 到 ，CompanyEmployee 类 中 的 getName 方法 根据 Company 和 Employee 接口 定义 的 两 个 
默认 方法 getName 构建 了 一 个 String。 

最 好 的 消息 是 ， 这 与 默认 方法 一 样 复 杂 。 读 者 现在 已 经 了 解 了 如 何 处 理 默认 方法 冲突 。 


实际 上 ， 我 们 还 要 考虑 一 种 极端 情况 。 如 果 Company 接口 定义 了 getName 方法 但 没有 将 其 
指定 为 default (也 不 存在 相应 的 实现 ， 即 getName 成 为 抽象 方法 )， 那么 当 Employee 接口 
也 定义 了 getName 方法 时 ， 是 否 还 会 导致 冲突 呢 ? 答案 是 肯定 的 。 有 趣 的 是 ， 仍 然 需要 在 
CompanyEmployee 类 中 提供 一 个 实现 。 

在 Java 8 之前， 如果 两 个 接口 包含 相同 的 方法 且 没 有 指定 为 默认 方法 ， 这 并 不 会 导致 冲 
突 ， 但 类 必须 提供 一 个 实现 。 





















































另 见 
有 关 接 口中 默认 方法 的 讨论 请 参见 范例 1.5。 


5.6 集合 与 映射 的 迭代 


问题 旦 厅 
用 户 希 望 对 集合 或 映射 进行 进 代 。 
方案 
使 用 java.lang.Iterable 或 java.util.Map 接口 新 增 的 默认 方法 forEach。 
讨论 
除了 使 用 循环 对 线性 集合 ( 即 实现 collection 或 其 后 代 的 类 ) 进行 迭代 外 ， 可 以 通过 
Iterable 接口 引入 的 点 认 方法 forEach 实现 同样 的 目的 。 
根据 Javadoc 的 描述 ，forEach 方法 的 签名 为 : 
default void forEach(Consumer<? suyper T> action) 


forEach 方法 的 参数 为 Consumer ， 它 是 java.util.function 包 引 入 的 一 种 函数 式 接口 ， 表 
示 传 入 一 个 泛 型 参数 (generic argument) 且 不 返回 任何 结果 的 操作 。 根 据 Javadoc 的 描述 ， 
“Consumer 与 大 部 分 函数 式 接口 不 同 ， 它 在 执行 时 会 产生 副作用 ”。 


纯 函 数 (pure function) 在 执行 时 不 会 产生 副作用 。 换 言 之 ， 如 果 参 数 相 
同 ， 则 每 次 返回 的 结果 也 相同 。 函 数 式 编程 将 其 称 为 引用 透明 性 (referential 
transparency)， 即 函数 可 以 被 它 的 值 所 禁 换 。 
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java.util.Collection 是 Iterable 的 子 接口 ， 此 forEach 方法 适用 于 从 ArrayList 到 
LinkedHashset 的 所 有 线性 集合 ， 这 使 得 线性 集合 的 迭代 易如反掌 (如 例 5-17 所 示 ) 。 


例 5-17 对 线性 集合 进行 迭代 
List<Integer> integers = Arrays.asList(3, 1, 4, 1, 5, 9); 
integers.forEach(new Consumer<Integer>() { 0 
@Override 
public void accept(Integer integer) { 
System.out.println(integer); 


} 
}); 


integers.forEach((Integer n) -> { ©@ 
System.out.println(n); 
]); 


integers.forEach(n -> System.out.printLn(n)); © 


integers .forEach(System.out::printLn); @ 


} 
@ 匿名 内 部 类 实现 
@ 完整 形式 的 lambda 代码 块 
@ lambda 表达 式 
@ 方法 引用 


在 本 例 中 ， 匿 名 内 部 类 只 是 显示 为 Consumer 接口 的 accept 方法 的 签名 。 观 察 内 部 类 可 知 ， 
accept 方法 传人 一 个 参数 并 返回 void， 本 例 所 用 的 lambda 表达 式 与 之 兼容 。 由 于 两 个 
lambda 表达 式 都 包含 对 System.out.println 方法 的 单 次 调用 ，forEach 方法 可 以 用 作 方 法 
引用 。 


Map 接口 同样 引入 forEach 方法 作为 默认 方法 ， 它 传人 BiConsunmer: 


default void forEach(BiConsumer<? super K, ? super V> action) 


BiConsumer 也 是 java.util.function 包 新 增 的 一 种 接口 ， 表 示 一 个 传 入 两 个 泛 型 参数 并 返 
回 void 的 函数 。 在 实现 Map 接口 的 forEach 方法 时 ， 参 数 是 entrySet 方法 中 Map.Entry 实 
例 的 键 和 值 。 


换言之 ， 对 Map 进行 迭代 现在 就 像 对 List、Set 或 其 他 任何 线性 集合 进行 迭代 一 样 简单 。 
示例 代码 如 例 5-18 所 示 。 


例 5-18 对 Map 进行 迄 代 
Map<Long, String> map = new HashMap<>(); 
map.put(86L, "Don Adams (Maxwell Smart)"); 
map.put(99L, "Barbara Feldon"); 
map.put(13L, "David Ketchum"); 
map.forEach((num, agent) -> 
System.out.printf("Agent %d, played by %s%n", num, agent)); 
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输出 如 例 $-195 所 示 。 
例 5-19 对 Map 迭代 后 的 输出 


Agent 99, played by Barbara FeLdon 
Agent 86, played by Don Adams (Maxwell Smart) 
Agent 13, played by David Ketchum 


在 Java 8 之 前 ， 为 了 实现 对 Map 的 迭代 ， 需 要 首先 通过 keyset 方法 获取 键 的 Set， 或 通过 
entrySet 方法 获取 Map.Entry 实例 。 而 Java 8 引入 的 默认 方法 forEach 使 欠 代 操作 得 以 简化 。 

















跳出 for-each 循环 并 非 易 事 ， 这 一 点 请 谨 记 在 心 。 为 解决 这 个 问题 ， 考 虑 将 
流 处 理 代码 重 写 为 filter 或 sorted， 并 后 跟 findFirst。 


























另 见 
有 关 国 数 式 接口 Consumer 和 BiConsumer 的 讨论 请 参见 范例 2.1。 


5.7 利用 Supplier 创 建 日 志 消 息 


问题 

用 户 希望 创建 由 日 志 级 别 (log level) 控制 是 否 可 见 的 日 志 消 息 。 

方案 

使 用 java.util.logging.Logger 类 新 增 的 各 种 日 志方 法 ， 它 们 传 入 Supplier 作为 参数 。 
讨论 

目前 ，Logger 类 中 的 日 0 (如 info、warning、severe 等 ) 包括 两 种 重 载 形式 ， 一 种 
传 入 单个 String 作为 参数 ， 另 一 种 传人 SuppLier<String> 作为 参数 。 

例 5-20 显示 了 各 种 日 志方 法 的 签名 。” 

例 5-20 Logger 类 中 各 种 日 志方 法 的 重 载 形式 


void config(String msg) 
void config(Supplier<String> msgSupplier) 




















注 6: 例 5-18 和 例 5-19 取 自 美国 经 典 电视 剧 《糊涂 侦探 》， 这 部 由 梅 尔 " 布鲁克 斯 (Mel Brooks) 和 巴克 。 
享 利 (Buck Henry) 编导 的 间谍 喜剧 在 1965 年 到 1970 年 间 播 出 。 主 角 麦 克 斯 书 . 史 马 特 (Maxwell 
Smart) 炉 合 了 詹姆斯 。 邦 德 与 雅克 。 克 和 鲁 索 (英国 电影 《糊涂 大 侦探 》 主 角 ) 的 特点 ,又 称 特工 86 号 
(Agent 86)。 他 的 女 搭档 是 特工 99 号 (Agent 99) ， 同 事 是 特工 13 号 (Agent 13 ) 。 

注 7: 读者 或 许 奇 怪 ，Java 日 志 框 架 的 设计 者 为 什么 不 采用 与 其 他 日 志 API 相 同 的 日 志 级 别 (Trace、 

Debug、Info、Warn、Error、Fatal)。 这 是 一 个 非常 好 的 问题 ， 如 果 读 者 找到 答案 ， 也 请 告诉 作者 。 
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void fine(String msg) 
void fine(Supplier<String> msgSupplier) 


void finer(String msg) 
void finer(Supplier<String> msgSupplier) 


void finest(String msg) 
void finest(Supplier<String> msgSupplier) 


void info(String msg) 
void info(Supplier<String> msgSupplier) 


void warning(String msg) 
void warning(Supplier<String> msgSupplier) 


void severe(String msg) 
void severe(Supplier<String> msgSupplier) 


每 种 方法 的 第 一 种 重 载 形式 (传人 String) 是 Java 1.4 引 入 的 ， 而 第 二 种 重 载 形 


品 


形式 〈 传 人 





Supplier) 是 Java 8 引入 的 ， 它 在 标准 库 中 的 实现 如 例 5-21 所 示 。 
例 5-21 Logger 类 的 实现 细节 


public 





void info(Supplier<String> msgSupplier) { 


log(Level.INFO, msgSupplier); 


} 


public void log(Level level, Supplier<String> msgSupplier) { 


if 


} 


(!isLoggable(level)) { 
return; 


LogRecord lr = new LogRecord(level, msgSupplier.get()); @ 
doLog( lr); 


@ 如 果 不 显示 消息 则 返 


@ 调用 get 


上 述 实 现 间 
(loggable) 。 
日 志方 法 中 ， 


以 将 其 转换 为 SuppLier， 





方法 以 便 在 Supplier 中 检索 消息 





第 二 种 重 载 形式 〈 传 和 人 Supplier) 支持 在 消息 


两 种 重 载 形式 。 
例 5-22 在 info 方 法 中 使 用 Supplier 


private Logger logger = Logger.getLogger(this.getClass().getName()); 
private List<String> data = new ArrayList<>(); 








// 用 数据 填充 列表 





logger. 
logger. 


info("The data is " + data.toString()); 0 
info(() -> "The data is " + data.toString()); @ 


F 韭 构建 一 个 永远 不 会 显示 的 消息 ， 而 是 检查 消息 是 否 是 “可 记录 的 ” 
如 果 所 提供 的 消息 是 一 个 简单 的 宇 符 昌 ， 程序 将 订 
前 添加 空 括号 和 箭头 (() ->) 
且 仅 当 日 志 级 别 合适 时 才 会 调用 它 。 例 5-22 显示 了 info 方法 的 


估 它 是 否 已 被 记录 。 在 上 述 











@ 无 论 是 否 显示 Info 消息 ， 都 会 构建 参数 

@ 仅 当 日 志 级 别 显示 Info 消息 时 ， 才 会 构建 参数 

可 以 看 到 ， 消 息 在 列表 的 每 个 对 象 上 调用 tostring 方法 。 在 第 一 条 Logger.info 语句 中 ， 
无 论 程 序 是 否 显示 Info 消息 ， 都 会 创建 结果 字符 串 ; 在 第 二 条 Logger.info 语句 中 ， 在 
消息 前 添加 () -> 就 能 将 日 志 参 数 转换 为 Supplier， 这 意味 着 只 有 使 用 消息 时 才 会 调用 
Supplier 的 get 方法 。 

采用 相同 类 型 的 supplier 替换 参数 的 技术 称 为 延迟 执行 (deferred execution) ， 可 以 在 任何 
对 象 创建 成 本 较 高 的 上 下 文中 使 用 。 




















另 见 
延迟 执行 是 Supplier 的 主要 用 例 之 一 ， 有 关 Supplier 接口 的 讨论 请 参见 苑 例 2.2。 


5.8 闭 包 复合 


问题 

用 户 希望 连续 应 用 一 系列 简单 且 独 立 的 函数 。 

方案 

使 用 Function、Consumer 与 Predicate 接口 中 定义 为 默认 方法 的 复合 方法 (composition 
method ) 。 


讨论 

函数 式 编程 的 优点 之 一 在 于 支持 创建 若干 简单 、 可 重复 使 用 的 函数 ， 将 这 些 函 数组 合 在 一 
起 就 能 解决 复杂 的 问题 。 为 此 ，java.util.function 包 引 入 的 函数 式 接口 定义 了 各 种 有 助 
于 简化 复合 操作 的 方法 。 

例如 ，Function 接口 包括 compose 和 andThen 两 种 默认 方法 ， 二 者 的 签名 如 例 5-23 所 示 。 
例 5-23 ”Function 接口 定义 的 复合 方法 


default <V> Function<V,R> compose(Function<? super V,? extends T> before) 
default <V> Function<T,V> andThen(Function<? super R,? extends V> after) 


从 方法 签名 中 的 哑 元 (dummy argument) 不 难看 出 两 种 方法 的 作用 : compose 方法 在 原始 
函数 之 前 应 用 其 参数 ， 而 andThen 方法 在 原始 函数 之 后 应 用 其 参数 。 

为 说 明 两 种 方法 的 应 用 ， 考 虑 例 5-24 所 示 的 简单 示例 。 

例 5-24 compose 和 andThen 方法 的 应 用 


Function<Integer, Integer> add2 
Function<Integer, Integer> mult3 






































X ->X+2; 
XX 
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Function<Integer, Integer> mult3add2 
Function<Integer, Integer> add2mmult3 


add2.compose(mult3); © 
add2.andThen(mult3); @ 


System.out.println("mult3add2(1): " + mult3add2.apply(1)); 
System.out.println("add2mult3(1): " + add2mult3.apply(1)); 


@ 先 执行 mutt3 函数 ， 再 执行 add2 函数 
@ 先 执行 add2 函数 ， 再 执行 mutt3 函数 
可 以 看 到 ，add2 函数 的 作用 是 将 参数 加 2， 而 mult3 函数 的 作用 是 将 参数 乘 3。 通 过 


compose 方法 创建 的 复合 函数 mult3add2 先 执 行 nuLtt3， 再 执行 add2; 通过 andThen 方法 创 
建 的 复合 函数 add2mult3 则 相反 ， 先 执行 add2， 再 执行 mult3。 


两 个 复合 函数 的 执行 结果 如 下 : 


mult3add2(1): 5 // 因为 (1 * 3) + 2 
add2mult3(1): 9 // 因为 (1 + 2) * 3 


复合 函数 的 结果 仍然 是 函数 ， 因 此 这 个 过 程 创 建 的 操作 可 供 今后 使 用 。 例 如 ， 如 果 收 到 的 
数据 属于 HTTP 请 求 的 一 部 分 ， 说 明 数 据 是 以 字符 串 形式 传输 的 。 虽 然 已 有 可 用 于 操作 数 
据 的 方法 ， 但 前 提 为 数据 是 数字 。 如 果 这 种 情况 频繁 发 生 ， 可 以 考虑 在 应 用 数值 操作 之 前 
编写 一 个 解析 字符 串 数 据 的 函数 。 详 见 例 5-25。 


例 5-25 首先 将 字符 串 解析 为 整数 ， 然 后 加 2 


Function<Integer, Integer> add2 =x ->x+2; 

Function<String, Integer> parseThenAdd2 = add2.compose(Integer::parseInt); 
System.out.println(parseThenAdd2.apply("1")); 

// 打印 3 


本 例 创建 了 一 个 名 为 parseThenAdd2 的 函数 ， 它 先 调用 静态 方法 Integer.parseInt， 再 将 
所 得 结果 加 2。 男 一 方面 ， 也 可 以 定义 一 个 先 执 行 数值 操作 ， 再 调用 tostring 方法 的 函 
数 ， 如 例 5-26 所 示 。 
例 5-26 首先 加 2， 然 后 将 数字 转换 为 字符 串 

Function<Integer, Integer> add2 =x ->x+2; 

Function<Integer, String> plus2toString = add2.andThen(Object::toString); 


System.out.println(plus2toString.apply(1)); 
// 打印 "3" 


上 述 操 作 返 回 一 个 函数 ， 它 传 入 Integer 参数 并 返回 String。 
如 例 5-27 所 示 ，Consumer 接口 也 定义 了 一 个 用 于 闭 包 复 合 的 方法 。 
例 5-27 Consumer 接口 定义 的 复合 方法 


default Consumer<T> andThen(Consumer<? Super T> after) 


根据 Javadoc 的 描述 ，andThen 方法 返回 一 个 复合 Consumer， 它 依次 执行 原始 操作 和 after 
指定 的 操作 。 如 果 执 行 任 一 操作 时 抛 出 异常 ， 异 常 将 被 转发 给 组 合 操作 的 调用 者 。 


示例 代码 如 例 5-28 所 示 。 
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例 5-28 用 于 打印 和 记录 的 复合 Consumer 
Logger Log = Logger .getLogger(...); 
Consumer<String> printer = System.out::printtLn; 
Consumer<String> Logger = log::info; 


Consumer<String> printThenLog = printer.andThen(logger); 
Stream.of("this", "is", "a", "stream", "of", "strings").forEach(printThenLog); 


程序 首先 创建 了 两 个 Consumer ， 一 个 用 于 打印 结果 到 控制 台 ， 另 一 个 用 于 日 志 记录 。 接 下 
来 ， 程 序 创建 了 一 个 复合 Consumer ， 可 以 一 次 性 打印 并 记录 流 的 所 有 元 素 。 


Predicate 接口 定义 了 三 种 用 于 谓词 复合 的 方法 ， 如 例 5-29 所 示 。 
例 5-29 Predicate 接口 定义 的 复合 方法 








default Predicate<T> and(Predicate<? super T> other) 
default Predicate<T> negate() 
default Predicate<T> or(Predicate<? super T> other) 





and、or、negate 方法 分 别 使 用 逻辑 与 、 逻 辑 或 、 逻 辑 非 操作 实现 谓词 的 复合 ， 每 种 方法 
返回 一 个 复合 Predicate。 

接 下 来 ， 我 们 讨论 一 个 关于 整数 的 有 趣 问 题 。 完 全 平方 数 (perfect square) 是 其 平方 根 同 
样 为 整数 的 数 ， 而 三 角形 数 (triangle number) 是 一 定数 目的 点 或 圆 在 等 距离 排列 下 可 以 形 
成 等 边 三 角形 的 数 "。 

例 5-30 创建 了 两 个 用 于 计算 完全 平方 数 和 三 角形 数 的 方法 ， 并 通过 and 方法 查找 既是 完 
平方 数 ， 又 是 三 角形 数 的 数 。 

例 5-30 ”既是 完全 平方 数 ， 又 是 三 角形 数 的 数 


public static boolean isPerfect(int x) { 0 
return Math.sqrt(x) % 1 == 0; 
} 

















public static boolean isTriangular(int x) { (2) 
double val = (Math.sqrt(8 * x + 1) - 1) / 2; 
return val % 1 == 0; 


} 
// 其 他 代码 





IntPredicate triangular = CompositionDemo::isTriangular; 
IntpPredicate perfect = CompositionDemo::isperfect; 
IntpPredicate both = triangular.and(perfect); 


IntStream.rangeClosed(1, 10_000) 
.filter(both) 
.forEach(System.out::println); © 
































注 8: 参见 维基 百科 有 关 “ 三 角形 数 ” 的 介绍 。 在 一 个 房间 中 ， 如 果 每 个 人 只 与 其 他 人 握手 一 次 ， 则 三 角形 
数 是 握手 次 数 的 总 和 。( 例 如 ， 房 间 中 有 2 个 人 时 握手 次 数 为 1， 有 3 个 人 时 握手 次 数 为 3， 有 4 个 人 
时 握手 次 数 为 6， 有 5 个 人 时 握手 次 数 为 10， 有 6 个 人 时 握手 次 数 为 1 5， 以 此 类 推 。 那么 1、3、6、 


a Ss 要 i a Se +1] SY 
10、15 就 是 前 5 个 三 角形 数 ， 第 #4 个 三 yg 数 的 计算 公式 为 一。 一 译 者 注 ) 
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@ 部 分 完全 平方 数 : 1、4、9、16、25、36、49、64、81……: 
@ 部 分 三 角形 数 : 1、3、6、10、15、21、28、36、45……: 

@ 既是 完全 平方 数 ， 又 是 三 角形 数 (1 到 10 000 之 间 ) : 1、36、1225 
借 由 复合 函数 ， 可 以 将 若干 简 单 的 函数 组 合 在 一 起 以 构建 复杂 的 操作 ”。 























另 见 
有 关 Function 接口 的 讨论 请 参见 范例 2.4， 有 关 Consumer 接口 的 讨论 请 参见 范例 2.1， 有 
关 Predicate 接口 的 讨论 请 参见 范例 2.3。 


5.9 ”利用 提取 的 方法 实现 异常 处 理 


问题 

lambda 表达 式 中 的 代码 需要 抛 出 异常 ， 但 用 户 不 希望 将 lambda 代码 块 与 异常 处 理 的 代码 
混在 一 起 。 

方案 

创建 一 个 单独 的 方法 来 执行 操作 、 处 理 异 常 ， 在 lambda 表达 式 中 调用 提取 的 方法 。 

















讨论 

lambda 表达 式 实际 上 属于 函数 式 接口 中 单一 抽象 方法 的 实现 。 与 匿名 内 部 类 一 样 ，lambda 
表达 式 只 能 抛 出 在 抽象 方法 签名 中 声明 的 异常 。 

如 果 所 需 的 异常 为 非 受 检 异 常 (unchecked exception)， 则 情况 相对 简单 。 所 有 非 受 检 异 常 
均 源 自 java.lang.RuntimeException 类 "与 其 他 Java 代码 类 似 ,lambda 表达 式 可 以 抛 出 运 
行 时 异常 (runtime exception) 而 不 必 进 并行 声明 或 将 代码 包装 在 try/eatch 块 中 ， 异 常 随后 被 
传送 给 调用 者 。 


例 5-31 创建 了 一 个 名 为 div 的 方法 ， 它 采用 常数 值 对 集合 中 所 有 元 素 进行 除法 操作 。 
例 5-31 可 能 抛 出 非 受 检 异 常 的 lambda 表达 式 


public List<Integer> div(List<Integer> values, Integer factor) { 
return values.stream() 
.map(n -> n / factor) © 
.collect(Collectors. toList()); 



































注 9: Unix 操作 系 乡 Te ee 
注 10: 这 可 能 是 整个 Java API 异常 均 在 运行 时 抛 出 (否则 它们 属于 编译 器 
潍 误 ) ， 那 么 将 这 个 类 命 名 为 io 不 是 更 直接 吧 ? 或 许 是 为 了 出 显 这 个 命名 的 糟糕 ， 
Java 8 引入 了 一 个 称 为 java.io.UncheckedIOException 的 类 ， 以 规避 本 范例 讨论 的 某 些 问题 


























@ 可 能 抛 出 ArithmeticException 


对 整数 除法 而 言 , 除数 为 0 将 抛 出 ArithmeticException ( 非 受 检 异 常 ) “, 它 将 传送 给 调用 
者 ， 如 例 5-32 所 示 。 


例 5-32 客户 端 代码 
List<Integer> valuyes = Arrays.asList(30, 10, 40, 10, 50, 90); 
List<Integer> scaled = demo.div(values, 10); 
System.out.println(scaled); 
// 打 EN[3, 1, 4, 1, 5, 9] 





scaled = demo.div(values, 0); 
System.out.println(scaled); 


// 抛 出 ArithmeticException (因为 除数 为 0) 


客户 端 代码 调用 div 方法 ， 如 果 除 数 为 0，lambda 表达 式 将 抛 出 ArithmeticException。 客 
户 端 可 以 在 map 方法 中 添加 一 个 try/catch 块 以 处 理 异 常 ， 但 代码 的 可 读 性 会 因此 而 变 得 很 
差 (如 例 5-33 所 示 )。 


例 5-33 包含 try/catch 代码 块 的 lambda 表达 式 
public List<Integer> div(List<Integer> values, Integer factor) { 
return values.stream() 
.map( n -> { 

try { 
return n / factor; 

} catch (ArithmeticException e) { 
e.printStackTrace(); 


























}) 


.collect(Collectors. toList()); 


} 
只 要 在 函数 式 接口 中 声明 受 检 异 常 (checked exception)， 就 能 应 用 上 述 过 程 。 


一 般 来 说 ， 应 尽量 保持 流 处 理 代码 的 简洁 ， 让 每 个 中 间 操 作 占 据 一 行 。 我 们 可 以 将 map 方法 内 
部 的 函数 提取 到 另 一 个 方法 以 简化 代码 ， 然 后 调用 这 个 方法 来 完成 流 处 理 ， 如 例 5-34 所 示 。 


例 5-34 将 lambda 表达 式 提取 到 另 一 个 方法 
private Integer divide(Integer value, Integer factor) { 
try { 
return value / factor; 
} catch (ArithmeticException e) {©O 
e.printStackTrace(); 








} 
} 


public List<Integer> divUsingMethod(List<Integer> values, Integer factor) { 
return values.stream() 





趣 的 是 ， 如 果 将 被 除数 和 除数 的 类 型 从 Integer 改 为 Double， 那 么 即便 除数 为 0.0， 程 序 也 不 会 抛 
任何 异常 ， 而 是 输出 一 个 所 有 元 素 为 “无 穷 大 ”(Infinity) 的 结果 。 无 论 读者 是 否 相信 ， 根 据 二 进 
I 计算 机 处 理 浮 点 数 需 要 遵循 的 IEEE 754 规范 ， 这 种 操作 是 合法 的 (作者 在 使 用 Fortran 语言 编程 时 
曾 被 这 种 情况 搞 得 十 分 头疼 ， 花 了 不 少时 间 才 摆 脱 这 个 焉 梦 ) 。 


注 11: 
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.map(n -> divide(n, factor)) @ 
.collect(Collectors. toList()); 
} 


@ 这 段 代 码 负责 处 理 异 常 
@ 流 处 理 代码 得 以 简化 
此 外 ， 如 果 提 取 的 方法 不 需要 factor 值 ， 则 map 方法 的 参数 可 以 简化 为 一 个 方法 引用 。 


将 lambda 表达 式 提取 到 单独 的 方法 同样 具有 不 少 优点 。 我 们 既 可 以 为 提取 的 方法 编写 测 
试 (对 于 私有 方法 则 使 用 反射 )， 也 可 以 在 方法 内 部 设置 断 点 ， 还 可 以 使 用 与 方法 相关 的 
其 他 机 制 。 
































另 见 
有 关 受 检 异 常 与 lambda 表达 式 的 讨论 请 参见 范例 S.10， 有 关 利 用 泛 型 包装 器 处 理 异 常 的 
讨论 请 参见 范例 5.11。 


5.10 ” 受 检 异常 与 lambda 表 达 式 


问题 
存在 一 个 抛 出 受 检 异 常 的 lambda 表达 式 ， 且 所 实现 的 函数 式 接口 中 的 抽象 方法 并 未 声明 
该 异常 。 
方案 


为 lambda 表达 式 添加 一 个 try/catch 代码 块 ， 或 委托 给 某 个 提取 的 方法 进行 处 理 。 











讨论 
lambda 表达 式 实际 上 属于 国 数 式 接口 中 单一 抽象 方法 的 实现 ， 因 此 只 能 抛 出 在 抽象 方法 签 
名 中 声明 的 受 检 异常 。 


假设 我 们 希望 通过 URL 调用 服务 ， 且 需要 根据 字符 串 参 数 的 集合 构建 一 个 查询 字符 串 ， 
那么 参数 应 该 采用 可 以 在 URL 中 使 用 的 方式 进行 编码 。 为 此 ，Java 提供 了 一 个 称 为 java. 
net.URLEncoder 的 类 (其 用 途 从 类 名 中 一 目 了 然 )， 包 括 一 个 静态 方法 encode， 它 传人 
string 作为 参数 ， 并 根据 指定 的 编码 方式 对 其 进行 编码 。 


我 们 很 容易 写 出 类 似 例 5-35 所 示 的 代码 。 
例 5-35 对 字符 串 集合 进行 URL 编码 (无 法 编译 ) 


public List<String> encodeValues(String... values) { 
return Arrays.stream(values) 
.map(s -> URLEncoder .encode(s, "UTF-8"))) © 
.collect(Collectors.toList()); 
































@ 抛 出 一 个 必须 处 理 的 异常 UnsupportedEncodingException 


encodeValues 方法 传 入 一 个 字符 串 的 可 变 参 数列 表 ， 并 根据 推荐 的 UTF-8 编码 方式 ， 尝 试 
采用 UREncoder .encode 方法 对 每 个 字符 串 进行 编码 。 然 而 ， 由 于 encodeValues 方法 抛 出 受 
检 异 常 UnsupportedEncodingException， 导 致 上 述 代 码 无 法 编译 。 


即便 声明 encodeValues 方法 抛 出 该 异常 ， 代 码 仍然 无 法 编译 
例 5-36 声明 异常 (仍然 无 法 编译 ) 


public List<String> encodeValues(String... values) 
throws UnsupportedEncodingException { ©@ 
return Arrays.stream(values) 
.map(s -> URLEncoder .encode(s, "UTF-8"))) 
.collect(Collectors. toList()); 

















o 


} 
@ 声明 encodeValues 方法 抛 出 UnsupportedEncodingException， 但 代码 仍然 无 法 编译 


问题 在 于 ， 从 lambda 表达 式 抛 出 异常 就 像 采 用 某 种 方法 构建 一 个 完全 独立 的 类 ， 并 从 中 
抛 出 异常 。 我 们 可 以 将 lambda 表达 式 视 为 匿名 内 部 类 的 实现 ， 由 此 可 见 ， 内 部 对 象 抛 出 
的 异常 仍然 需要 在 内 部 对 象 而 非 周围 对 象 (surrounding object) 中 进行 处 理 或 声明 。 正 确 
的 代码 如 例 5-37 所 示 ， 包 括 匿 名 内 部 类 和 lambda 表达 式 两 种 实现 。 


例 5-37 利用 try/catch 代码 块 进行 URL 编码 (可 以 编译 ) 
public List<String> encodeValuesAnonInnerClass(String... values) { 
return Arrays.stream(values) 
.map(new Function<String, String>() { 0 
@Override 
public String apply(String s) { ©@ 
try { 
return URLEncoder .encode(s, "UTF-8"); 
} catch (UnsupportedEncodingException e) { 
e.printStackTrace(); 
return ""; 



































}) 
.collect(Collectors.toList()); 


} 


public List<String> encodeValues(String... values) { 【3) 
return Arrays.stream(values) 
.map(s -> { 
try { 
return URLEncoder .encode(s, "UTF-8"); 
} catch (UnsupportedEncodingException e) { 
e.printStackTrace(); 
return ""; 
} 
}) 
.collect(Collectors.toList()); 


} 
@ 匿名 内 部 类 实现 
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@ 包含 将 抛 出 受 检 蜡 常 的 代码 
@ lambda 表达 式 实 现 


由 于 apply 方法 (Function 接口 包含 的 单一 抽象 方法 ) 并 未 声明 任何 受 检 异 常 ， 必 须 在 任 
何 实现 该 方法 的 lambda 表达 式 中 添加 一 个 try/catch 代码 块 。 如 果 使 用 lambda 表达 式 (如 
本 例 所 示 )， 我 们 甚至 无 法 看 到 apply 方法 签名 ， 退 论 对 其 进行 修改 (程序 也 不 允许 )。 


例 5-38 显示 了 如 何 利 用 提取 的 方法 进行 编码 。 


例 5-38 委托 给 encodeSstring 方法 进行 URL 编码 
private String encodeString(String s) {© 
try { 
return URLEncoder .encode(s, "UTF-8"); 
} catch (UnsupportedEncodingException e) { 
throw new RuntimeException(e); 






































} 


public List<String> encodeValuesUsingMethod(String... values) { 
return Arrays.stream(values) 
.map(this: :encodeString) @ 
.collect(Collectors.toList()); 


} 
@ 用 于 异常 处 理 的 提取 方法 
@ 提取 方法 的 方法 引用 


上 述 代 码 有 效 且 易 于 实现 ， 并 提供 了 一 种 可 以 分 别 进行 测试 和 调试 的 方法 。 唯 一 的 不 足 之 
处 在 于 ， 我 们 需要 为 每 个 可 能 抛 出 异常 的 操作 提取 一 个 方法 。 但 前 面 的 范例 曾经 提 到 过 ， 
这 使 得 对 流 处 理 的 各 个 组 件 进 行 测试 更 加 容易 。 



































另 见 
有 关 利 用 提取 的 方法 处 理 lambda 表达 式 中 的 异常 请 参见 范例 5.9， 有 关 利 用 泛 型 包装 器 处 
时 异常 的 讨论 请 参见 范例 5.11。 


5.11 泛 型 异常 包装 器 的 应 用 


问题 
存在 一 个 抛 出 异常 的 lambda 表达 式 ， 但 用 户 希 望 使 用 泛 型 包装 器 (generic wrapper) 来 捕 
获 所 有 受 检 异 常 ， 并 将 它们 作为 非 受 检 异 常 重新 抛 出 。 


方案 
创建 特殊 的 异常 类 (exception class) ， 添 加 一 个 接受 这 些 类 的 泛 型 方法 ， 并 返回 不 抛 出 异 
常 的 lambda 表达 式 。 




















i 




















讨论 

范例 5.9 和 范例 5.10 讨论 了 如 何 委托 一 个 单独 的 方法 来 处 理 lambda 表达 式 抛 出 的 异常 ， 
不 过 我 们 需要 为 每 个 可 能 抛 出 异常 的 操作 定义 一 个 私有 方法 。 可 以 采用 泛 型 包装 器 使 其 更 
为 通用 。 

为 此 ， 我 们 定义 一 个 单独 的 函数 式 接口 ， 它 包含 一 个 声明 抛 出 Exception 的 方法 ， 然 后 通 
过 某 种 包装 器 方法 (wrapper method) 将 其 连接 到 用 户 代码 。 


例如 ，Stream 接口 的 map 方法 需要 一 个 Function， 但 Function 接口 的 apply 方法 不 会 声明 
任何 受 检 异 常 。 为 了 在 map 方法 中 使 用 可 能 抛 出 受 检 异 常 的 lambda 表达 式 ， 我 们 创建 一 个 
单独 的 函数 式 接口 ， 声 明 它 将 抛 出 Exception， 如 例 5-39 所 示 。 


例 5-39 抛 出 Exception 的 函数 式 接口 
@FunctionalInterface 
public interface FunctionWithException<T, R, E extends Exception> { 
R apply(T t) throws E; 












































接 下 来 ， 在 try/catch 代码 块 中 包装 apply 方法 ， 以 添加 一 个 传人 FunctionWithException 并 
返回 Function 的 包装 器 方法 ， 如 例 5-40 所 示 。 


例 5-40 用 于 处 理 异常 的 包装 器 方法 
private static <T, R, E extends Exception> 
Function<T, R> wrapper(FunctionWithException<T, R, E> fe) { 
return arg -> { 

try { 
return fe.apply(arg); 

} catch (Exception e) { 
throw new RuntimeException(e); 








} 
}; 
} 


如 上 所 示 ，wrapper 方法 接受 抛 出 Exception 的 代码 ， 并 构建 必要 的 try/catch 块 ， 同 时 委托 


给 apply 方法 。 在 本 例 中 ，wrapper 方法 被 声明 为 static， 但 这 并 非 强 制 要 求 。 如 例 5-41 
所 示 ， 我 们 可 以 使 用 任何 抛 出 异常 的 Function 来 调用 包装 器 。 


例 5-41 泛 型 静态 包装 器 方法 的 应 用 
public List<String> encodeValuesWithWrapper(String... values) { 
return Arrays.stream(values) 
.map(wrapper(s -> URLEncoder .encode(s, "UTF-8"))) ©@ 
.collect(Collectors.toList()); 








} 
@ 使 用 wrapper 方法 


接 下 来 ， 可 以 在 抛 出 异常 的 map 操作 中 编写 代码 ，wrapper 方法 会 将 其 作为 未 受 检 异 常 重 
新 抛 出 。 这 种 方案 的 不 足 之 处 在 于 ， 需 要 为 所 有 计划 使 用 的 函数 式 接口 创建 单独 的 泛 型 包 
装 器 (如 ConsumerWithException 和 SupplierWithException)。 





























流 式 操作 、lambda 表 达 式 与 方法 引用 的 相关 问题 | 115 











这 未 免 有 些 复杂 。 有 鉴于 此 ， 不 难 理解 为 何某 些 Java 框架 (如 Spring 和 Hibernate) 甚至 
整个 语言 (如 Groovy 和 Kotlin) 在 捕获 所 有 受 检 异常 后 ， 再 将 它们 作为 非 受 检 异 常 重新 
抛 出 。 



























































另 见 
有 关 受 检 蜡 常 与 lambda 表达 式 的 讨论 请 参见 范例 5.10， 有 关 利 用 提取 的 方法 处 理 lambda 
表达 式 中 的 异常 请 参见 范例 5.9。 























第 6 章 





0ptional 类 


唉 ， 为 什么 只 要 与 Optional 类 有 关 的 话题 ， 就 有 那么 多 消息 呢 ? 





Brian Goetz 
lambda-libs-spec-experts 邮件 列表 管理 员 
(2013 年 10 月 23 日 ) 


Java 8 API 引入 了 一 种 称 为 java.util.0ptional<T> 的 类 。 虽 然 不 少 开发 人 员 认 为 这 个 类 的 
作用 是 从 代码 中 删除 NuLLPointerException， 不 过 其 实际 用 途 并 非 如 此 。 相 反 ，0ptional 
类 设计 用 来 在 返回 值 可 能 合法 为 nutl 时 与 用 户 通信 。 如 果 根 据 茶 些 条 件 过 滤 值 流 后 恰好 没 
有 元 素 存 留 ， 就 会 出 现 返 回 值 合法 为 null 的 情况 。 

















在 Stream API 中 ， 如 果 流 中 没有 元 素 ，reduce、min、max、findFirst 以 及 findAny 方法 将 





返回 0ptional。 


0 
( 


ptional 实例 具有 两 种 状态 ， 要 么 是 对 T 类 型 实例 的 引用 ， 要 么 为 空 。 前 者 称 为 存在 
present) ， 后 者 称 为 空 (empty， 与 null 相对 )。 


虽然 Optional 是 一 种 引用 类 型 ， 但 不 应 被 赋值 为 nutL， 否 则 将 导致 严重 的 
错误 。 








这 一 章 着 眼 于 0ptional 的 各 种 习惯 用 法 。 如 何 正 确 使 用 0ptional 可 能 引发 公司 内 部 的 激烈 
争论 ， 好 在 有 一 些 标准 建议 可 供 参考 ,遵循 这 些 原 则 有 助 于 在 讨论 时 清晰 传递 我 们 的 意图 。 











如 


EE 1: 作者 对 于 这 种 讨论 相当 老练 。 
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6.1 Optional 的 创建 


问题 

用 户 希望 从 现 有 值 返回 0ptional。 

方案 

使 用 0ptional.of、0Optional.ofNullable 或 Optional.empty 方法 。 

讨论 

与 Java 8 新 增 的 众多 类 一 样 ，0ptional 实例 也 是 不 可 变 的 (immutable)。API 将 0ptional 
称 为 基于 值 的 类 (value-based class) ， 即 0ptional 实例 : 


。 被 声明 为 final 上 且 是 不 可 变 “的 (但 可 能 包含 对 可 变 对 象 的 引用 ) ， 
。 不 提供 公共 构造 函数 (public constructor) ， 因 此 必须 采用 工厂 方法 加 以 实例 化 ; 
。 具有 equals、hashCode 与 tostring 的 实现 ， 这 些 实现 是 通过 实例 的 状态 计算 出 来 的 。 























Optional 与 不 可 变性 
Optional 实例 是 不 可 变 的 ， 但 它 包 装 的 对 象 却 不 一 定 是 不 可 变 的 。 如 果 创 建 一 个 包含 
可 变 对 象 实例 的 Optional, 则 仍 然 可 以 对 实例 进行 修改 ， 如 例 6-1 所 示 < 
例 6-1 optional 是 不 可 变 的 吗 ? 


AtomicInteger counter = new AtomicInteger(); 
Optional<AtomicInteger> opt = Optional.ofNullable(counter); 


System.out.println(optional); // Optional[0] 
counter .incrementAndGet(); 0 
System.out.println(optional); // Optional[1] 
optional.get().incrementAndGet(); [2) 
System.out.println(optional); // Optional[2] 


optional = Optional.ofNullable(new AtomicInteger()); © 
@ 直接 使 用 计数 器 自 增 
@@ 检索 包含 的 值 并 自 增 
四 可 以 对 0ptional 引用 重新 赋值 

















注 2: 有 关 不 可 变性 的 讨论 请 参见 “0ptional 与 不 可 变性 ”注释 。 
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我 们 既 可 以 通过 原始 引用 修改 包含 的 值 ， 也 可 以 在 0ptionaL 上 调用 get 以 检索 某 个 值 
进行 修改 。 我 们 其 至 可 以 对 引用 本 身 重新 赋值 ， 换 言 之 ,不 能 将 不 可 变性 与 final 混 为 
一 谈 。 但 是 ， 无 法 对 0ptional 实例 本 身 进 行 修改 ， 因 为 不 存在 能 执行 这 种 操作 的 方法 。 


对 “不 可 变 ” 的 定义 略 显 模糊 ， 这 在 Java 中 并 不 鲜 见 。Java 并 未 提供 一 种 良好 的 内 置 
方式 来 创建 只 能 产生 无 法 改变 的 对 象 的 类 。 














我 们 可 以 通过 静态 工厂 方法 empty、of 与 ofNullable 来 创建 0ptionaL， 三 者 的 签名 如 下 : 


static <T> Optional<T> empty() 
static <T> Optional<T> of(T value) 
static <T> Optional<T> ofNullable(T value) 


显而易见 ，empty 方法 将 返回 一 个 空 0ptional。 如 果 参 数 为 null，of 方法 将 返回 一 个 包装 
指定 值 或 抛 出 异常 的 0ptionaL， 其 应 用 如 例 6-2 所 示 。 
例 6-2 通过 of 方法 创建 0ptional 


public static <T> Optional<T> createOptionalTheHardWay(T value) { 
return vaLue == null ? Optional.empty() : Optional.of(value); 



































} 
在 本 例 中 ，createOptionalTheHardWay 之 所 以 被 命名 为 “The Hard Way”， 并 非 因为 它 难 以 
实现 ， 而 是 存在 另 一 种 更 简单 的 方法 ， 这 就 是 例 6-3 所 示 的 ofNullable 方法 。 


例 6-3 通过 ofNullable 方法 创建 0ptional 
public static <T> Optional<T> createOptionalTheEasyWay(T value) { 
return Optional.ofNullable(value); 











} 


在 Java 8 的 引用 实现 中 ，ofNullable 方法 的 实现 其 实 就 是 create0ptionalTheHardway 中 的 
语句 : 检查 包含 的 值 是 否 为 nutL， 若 是 ， 则 返回 一 个 空 Optional， 否 则 使 用 of 方法 进行 
包装 。 

此 外 ， 包 装 基本 数据 类 型 的 0ptionalInt、0ptionalLong 与 OptionalDouble 类 不 能 为 null， 
因此 三 者 只 有 of 方法， 没有 ofNullable 方法 。 


static OptionalInt of(int value) 
static OptionalLong of(long value) 
static OptionalDouble of(double value) 




















请 注意 ， 三 个 类 的 getter 方法 分 别 为 getAsInt、getAsLong 与 getAsDouble， 而 不 是 getInt、 
getLong 与 getDouble, 


另 见 
本 章 其 他 范例 〈 如 范例 6.4 和 范例 6.5) 根据 提供 的 集合 (而 非 现 有 值 ) 来 创建 0ptional 
值 ， 范 例 6.3 使 用 本 范例 讨论 的 方法 来 包装 提供 的 值 。 
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6.2 ”从 Optional 中 检索 值 


问题 

用 户 希 望 从 0ptional 中 提取 包含 的 值 。 

方案 

如 果 确 定 Optional 中 存在 值 ， 则 使 用 get 方法 ， 否 则 使 用 orElse 方法 的 某 种 形式 。 如 果 
只 希望 当 值 存在 时 才 执 行 Consumer， 也 可 以 使 用 ifPresent 方法 。 























讨论 
当 调用 一 个 返回 0ptional 的 方法 时 ， 可 以 通过 调用 get 方法 来 检索 其 中 包含 的 值 。 如 果 
Optional 为 空 ，get 方法 将 抛 出 NoSuchElementException。 


接 下 来 ， 我 们 讨论 如 何 从 一 个 字符 串 流 中 返回 第 一 个 偶数 长 度 的 字符 串 ， 如 例 6-4 所 示 。 
例 6-4 检索 第 一 个 偶数 长 度 的 字符 串 


Optional<String> firstEven = 
Stream.of("five", "even", "length", "string", "values") 
.filter(s -> s.length() % 2 == 0) 
.findFirst(); 
由 于 流 中 的 所 有 字符 串 都 无 法 通过 筛选 器 ，findFirst 方法 将 返回 0ptionaL<String>。 可 以 
通过 在 Optional 上 调用 get 方法 来 打印 返回 值 : 


System.out.printtn(firstEven.get()) // 即便 这 条 语句 可 以 执行 ， 也 应 避免 使 用 


请 注意 ， 虽 然 上 述 语句 可 以 执行 ， 但 除非 确定 Optional 中 包含 值 ， 否 则 不 要 调用 get 方 
法 ， 以 免 程 序 抛 出 异常 ， 如 例 6-5 所 示 。 


例 6-5 ”检索 第 一 个 奇数 长 度 的 字符 串 


Optional<String> first0dd = 
Stream.of("five", "even", "length", "string", "values") 
.filter(s -> s.length() % 2 != 0) 
.findFirst(); 


















































System.out.printLn(first0dd.get()); // 抛 出 NoSuchElementException 


我 们 可 以 采用 多 种 方案 解决 这 个 问题 。 例 如 ， 首 先 确 定 0ptionalt 中 是 否 包含 值 ， 然 后 再 检 
索 ， 如 例 6-6 所 示 。 


例 6-6 ”检索 第 一 个 偶数 长 度 的 字符 串 〈 先 确定 是 否 包含 值 ， 再 使 用 get 方法 ) 
Optional<String> firstEven = 0 
Stream.of("five", "even", "length", "string", "values") 
.filter(s -> s.length() % 2 == 0) 
.findFirst(); 


System.out.println( 
first.ispresent() ? first.get() : "No even length strings"); @ 





@ 与 例 6-4 所 示 的 代码 相同 
@ 仅 当 ispPresent 方法 返回 true 时 才 调 用 get 方法 


不 过 ， 虽 然 上 述 代 码 可 以 执行 ,但 只 是 添加 了 一 个 isPresent 方法 进行 非 空 验证 ， 程 序 并 
未 有 太 大 改进 。 


所 幸 我 们 还 有 一 个 更 好 的 选择 ， 这 就 是 非常 方便 的 orElse 方法 ， 如 例 6-7 所 示 。 
例 6-7 使 用 orElse 方 法 


Optional<String> firstOdd = 
Stream.of("five", "even", "length", "string", "values") 
.filter(s -> s.length() % 2 != 0) 
.findFirst(); 


System.out.printLn(first0dd.orELse("No odd Length strings")); 


如 果 包 含 的 值 存在 ， 则 orElse 方法 返回 该 值 ， 否 则 返回 提供 的 默认 值 。 因 此 ， 如 果 已 有 回 

退 值 (fallback value) ， 那 么 采用 orElse 方法 是 相当 方便 的 。 

orElse 方法 包括 三 种 形式 。 

。 当 包 含 的 值 存在 时 ，orELse(T other) 将 返回 该 值 ， 否 则 返回 指定 的 默认 值 other。 

。 当 包 含 的 值 存在 时 ，orElseGet(Supplier<? extends T> other) 将 返回 该 值 ， 否 则 调用 
Supplier 并 返回 相应 的 结果 。 

。 当 包 含 的 值 存在 时 ，orELseThrow(SuppLier<? extends X> exceptionSupplier) 将 返回 该 
值 ， 否 则 抛 出 由 Supplier 产生 的 异常 。 

orElse 与 orELseGet 方法 的 不 同 之 处 在 于 ， 无 论 0ptional 中 是 否 存在 值 ，orELse 总 会 创建 

新 字符 串 ， 而 orELseGet 使 用 Supplier， 仅 在 Optional 为 空 时 才 执 行 。 

如 果 值 只 是 一 个 简单 的 字符 串 ， 那 么 orElse 与 orELseGet 方法 的 区 别 可 以 忽略 不 计 ， 如 果 

orElse 方法 的 参数 是 一 个 复杂 对 象 ， 那 么 传人 Supplier 的 orELseGet 方法 能 确保 仅 在 需要 

时 才 创 建 对 象 。 相 关 示 例如 例 6-8 所 示 。 

例 6-8 在 orELseGet 方法 中 使 用 SuppLier 


Optional<ComplexObject> val = values.stream.findFirst() 




































































val.orElse(new ComplexObject()); 0 
val.orElseGet(() -> new ComplexObject()) @ 


@ 总 是 创建 新 对 象 
@ 仅 在 需要 时 才 创 建 对 象 
采用 Supplier 作为 方法 参数 是 延迟 执行 (deferred execution) 或 情 性 执行 


(lazy execution) 的 一 种 应 用 ， 从 而 可 以 仅 在 需要 时 才 在 SuppLier 上 调用 get 
方法 。” 

















注 3: 参见 Venkat Subramaniam 撰写 的 《Groovy 程序 设计 》 一 书 ， 第 6 章 详 细 讨 论 了 这 个 问题 。 
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在 Java 标准 库 中 ，orELseGet 方法 的 实现 如 例 6-9 所 示 。 


例 6-9 orELseGet 方法 的 实现 
public T orElseGet(Supplier<? extends T> other ) { 
return vaLue != null ? value : other.get(); © 


} 
@ value 是 0ptional 中 T 类 型 的 最 终 特性 
orELseThrow 方法 同样 传人 Supplier ， 该 方法 的 签名 如 下 : 

<X extends Throwable> T orElseThrow(Supplier<? extends X> exceptionSupplier) 
因此 ， 当 0ptional 包含 值 时 ， 不 会 执行 用 作 Supplier 参数 的 构造 函数 引用 ， 如 例 6-10 所 示 。 


例 6-10 采用 orElseThrow 作为 Supplier 
Optional<String> first = 
Stream.of("five", "even", "length", "string", "values") 
.filter(s -> s.length() % 2 == 0) 
.findFirst(); 











System.out.println(first.orElseThrow(NoSuchElementException: :new)); 


此 外 ，ifPresent 方法 支持 提供 一 个 仅 当 0ptional 包含 值 时 才 执 行 的 Consumer ， 如 例 6-11 
所 示 。 


例 6-11 ifpresent 方法 的 应 用 
Optional<String> first = 
Stream.of("five", "even", "length", "string", "values") 
.filter(s -> s.length() % 2 == 0) 
.findFirst(); 

















first.ifpresent(val -> System.out.println("Found an even-Length string")); 
first = Stream.of("five", "even", "length", "string", "values") 

.filter(s -> s.length() % 2 != 0) 

.findFirst(); 


first.ifpresent(val -> System.out.println("Found an odd-length string")); 


执行 上 述 程序 将 仅 打 印 “Found an even-length string” 消 息 。 





另 见 
有 关 Supplier 接口 的 讨论 请 参见 范例 2.2， 0 函数 引用 的 讨论 请 参见 范例 1.3， 有 关 
返回 0ptional 的 findAny 和 findFirst 方法 请 参见 范例 3.9。 





6.3 人 的 Optional 


问题 
用 户 希 望 在 访问 器 (accessor) 和 更 改 器 (mutator) 中 使 用 0ptional。 





A 
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方案 
在 0ptional 中 包装 getter 方法 的 结果 ， 但 不 要 对 setter 方法 ， 尤 其 是 特性 (attribute) 执行 
同样 的 操作 。 


讨论 

在 0ptional 数据 类 型 与 用 户 通 信 的 过 程 中 ， 操 作 结 果 可 以 合法 为 nutLLt 而 不 会 抛 出 
NullPointerException。 但 是 ，0ptional 类 被 有 意 设 计 成 不 可 序列 化 (non-serializable) ， 所 
以 不 应 使 用 它 来 包装 类 中 的 字段 。 

因此 ， 在 getter 和 setter 方法 中 添加 0ptional 的 首选 方案 ， 是 当 getter 返回 时 在 其 中 包装 
可 空 特性 (nullable attribute)， 但 不 要 对 setter 执行 同样 的 操作 。 相 关 示 例如 例 6-12 所 示 。 
例 6-12 在 DAO (数据 访问 对 象 ) 层 中 使 用 0ptional 


public class Department { 
private Manager boss; 

















public Optional<Manager> getBoss() { 
return Optional.ofNullable(boss); 
上 


public void setBoss(Manager boss) { 
this.boss = boss; 
} 
} 


在 本 例 中 ,boss 是 Department 类 中 的 Manager 特性 ， 可 以 将 其 视 为 可 空 类 型 “。 用 户 或 许 试 
图 创建 类 型 为 Optional<Manager> 的 特性 ， 但 由 于 0ptional 不 可 序列 化 ，Department 也 不 
可 序列 化 。 


本 例 不 要 求 用 户 包装 0ptionat 中 的 值 以 调用 setter 方法 ,但 这 是 setBoss 方法 传 入 0ptional 
<Manager> 作为 参数 所 必需 的 。0ptional 用 于 表示 一 个 可 能 合法 为 nutLL 的 值 ， 且 客户 端 已 
经 了 解 该 值 是 否 为 nutL， 但 内 部 实现 并 不 关心 该 值 是 否 为 null。 

此 外 ， 在 getter 方法 中 返回 0ptional<Manager> 将 告知 调用 程序 ， 此 时 Department 可 能 
(也 可 能 设 有 ) boss。 

本 例 的 不 足 之 处 在 于 ， 多 年 以 来 ,“JavaBeans” 规 范 基 于 特性 “对 称 ” 地 定义 了 getter 和 
setter。 实 际 上 ，Java 将 属性 (property) 一 一 而 不 仅仅 是 特性 (attribute) 一 一 定义 为 遵循 
标准 模式 的 getter 和 setter。 而 本 范例 讨论 的 方案 违反 了 这 种 模式 ，getter 和 setter 不 再 是 对 
称 的 。 

有 鉴于 此 ， 部 分 开发 人 员 认 为 getter 和 setter 方法 中 不 应 出 现 0ptionaL， 它 属于 不 应 暴露 
给 客户 端的 内 部 实现 细节 。 

不 过 ， 本 范例 讨论 的 方案 被 使 用 Hibernate 等 ORM (对 象 关 系 映 射 ) 工具 的 开源 开发 者 













































































注 4: 或 许 这 是 个 一 厢 情 愿 但 颇具 吸引 力 的 想法 。 
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所 广泛 接受 。 首 要 问题 是 告知 客户 端 ， 存 在 一 个 支持 特定 字段 的 可 空 数 据 库 列 (nullable 
database column) ， 而 不 必 强 制 客户 端 在 setter 方法 中 包装 引用 。 


这 似乎 是 一 种 合理 的 折 中 方案 ， 但 正如 这 些 开 发 者 所 言 ， 解 决 方案 应 根据 具体 情况 而 定 。 





另 见 
有 关 0ptional.map 方法 的 讨论 请 参见 范例 6.5， 有 关 在 0ptional 中 包装 值 的 讨论 请 参见 范 
例 6.1。 

















6.4 Optional.flatMap 与 Optional.map 方 法 


问题 
用 户 希 望 避免 将 一 个 0ptional 包装 在 另 一 个 0ptional 中 。 


方案 
使 用 0ptional 类 定义 的 fLatMap 方法 。 


讨论 
有 关 Streanm 接口 定义 的 nap 和 flatMap 方法 请 参见 范例 3.11。 不 过 flatMap 是 一 个 通用 的 
概念 ， 同 样 可 以 用 于 0ptional。 

Optional.flatMap 方法 的 签名 如 下 : 


<U> Optional<U> flatMap(Function<? super T, Optional<U>> mapper) 


Optional.flatMap 方法 的 签名 与 Optional.map 方法 类 似 ， 二 者 的 Function 参数 应 用 于 每 个 
元 素 并 生成 一 个 结果 ， 返 回 类 型 为 opttonat<U>。 具 体 而 言 ， 如 果 参 数 T 存 在 ，optionat 
flatMap 方法 将 国 数 应 用 于 T 并 返回 0ptionaL， 它 包装 包含 的 值 ， 如 果 T 不 存在 ， 方 法 将 
返回 一 个 空 0ptional。 

根据 范例 6.3 的 讨论 ， 数 据 访 问 对 象 (DAO) 通常 采用 返回 0ptional 的 getter 方法 编写 
(如 果 属 性 可 以 为 nutL) ， 但 setter 方法 不 会 将 参数 包装 在 0ptional 中 。 例 6-13 显示 了 两 
个 类 ， 一 个 是 Manager 类 ， 它 包含 非 空 字符 串 name， 男 一 个 是 Department 类 ， 它 包含 可 空 
Manager 特性 boss。 

例 6-13 包含 optional 的 DAO 层 (部分) 


public class Manager { 
private String name; 0 
































public Manager(String name) { 
this.name = name; 





public String getName() { 
return nName; 
站 


public class Department { 
private Manager boss; © 


public Optional<Manager> getBoss() { 
return Optional.ofNullable(boss); 
} 


public void setBoss(Manager boss) { 
this.boss = boss; 


} 
} 


@ 假定 不 为 nuLL， 因 此 不 需要 0ptional 


@ 可 能 为 nutL， 因 此 在 0ptionat 中 包装 getter 方法 并 返回 ， 但 不 要 对 setter 方法 执行 同样 
的 操作 


如 果 客 户 端 调用 Department 的 getBoss 方法 ， 结 果 将 被 包装 在 0ptional 中 ， 如 例 6-14 所 示 。 
例 6-14 返回 0ptional 


Manager mrSlate = new Manager("Mr. Slate"); 





让 























Department d = new Department(); 
d.setBoss(mrSlate); 0 
System.out.println("Boss: " + d.getBoss()); ©@ 


Department d1 = new Department(); © 
System.out.println("Boss: " + d1.getBoss()); @ 


@ Department 中 存在 非 空 Manager 


@ 打印 Boss: Optional[Manager{name='Mr. Slate'}] 





四 Department 中 不 存在 Manager 

@ 打印 Boss: Optional.empty 

截至 目前 一 切 顺 利 。 如 果 Department 中 存在 Manager ，getter 方法 将 其 包装 在 Optional 中 
并 返回 ;如果 Department 中 不 存在 Manager ，getter 方法 将 返回 一 个 空 0ptional。 


问题 在 于 ， 无 法 通过 在 0ptional 上 调用 getName 方法 来 获取 Manager 的 name。 我 们 要 么 从 
Optional 中 取出 包含 的 值 ， 要 么 使 用 map 方法 ( 例 6-15)。 


例 6-15 从 0ptional 的 Manager 中 提取 name 





























System.out.printLn("Name: " + 

d.getBoss().orElse(new Manager("Unknown'" ) ) .getName()); © 
System.out.printLn("Name: " + 
d1i.getBoss().orElse(new Manager("Unknown")).getName()); 
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System.out.printLn("Name: 
System.out.printLn("Name : 


+ d.getBoss().map(Manager::getName)); ©@ 
+ d1i.getBoss().map(Manager: :getName)); 


@ 在 调用 getName 方法 之 前 从 0ptional 中 提取 boss 
@ 利用 map 方法 将 getName 应 用 于 包含 的 Manager 





仅 当 map 方法 所 调用 的 0ptional 不 为 空 时 ， 该 方法 才 会 应 用 给 定 函 数 ， 因 此 这 种 方案 更 为 





简单 。map 方法 的 详细 讨论 请 参见 范例 6.5。 




















不 过 ， 如 果 多 个 0ptional 链接 在 一 起 ， 情 况 将 变 得 较为 复杂 。 例 6-16 定义 了 一 个 名 为 
Company 的 类 ， 它 只 包含 一 个 Department (为 简单 起 见 ， 只 考虑 一 个 Department 的 情况 ) 。 





例 6-16 只 包含 一 个 Department 的 Company 


public class Company { 
private Department department; 


public Optional<Department> getDepartment() { 
return Optional.ofNullable(department); 


} 


public void setDepartment(Department department) { 
this.department = department; 
} 
} 



































如 果 在 Company 类 上 调用 getDepartment 方 法 ， 结 果 将 被 包装 在 Optional 中 。 为 获取 
Manager 的 信息 ， 似 乎 可 以 采用 例 6-15 讨论 的 map 方法 ， 但 这 会 导致 一 个 0ptional 被 包装 


在 另 一 个 0ptional 中 ， 如 例 6-17 所 示 。 
例 6-17 包装 在 另 一 个 Optional 中 的 0ptional 


Company co = new Company(); 
co.setDepartment(d); 





System.out.println("Company Dept: " + co.getDepartment()); 0 


System.out.println("Company Dept Manager: + Co.getDepartment() 
.map(Department: :getBoss)); 2) 


@ 打印 Company Dept: Optional[Department{boss=Manager{name='Mr.Slate'}}] 
@ 打印 Company Dept Manager: Optional[Optional[Manager{name='Mr.Slate'}]] 
为 解决 这 个 问题 ， 不 妨 使 用 0ptional.flatMap 方法 。flatMap 方法 可 以 将 结构 “ 展 平 ”， 














因 


此 只 会 返回 一 个 0ptional。 我 们 仍然 按 之 前 的 方式 创建 Company 类 ， 然 后 应 用 fLatMap 方 


法 ， 如 例 6-18 所 示 。 


例 6-18 在 Company 上 应 用 flatMap 
System.out.printLn( 





co.getDepartment() 0 
.flatMap(Department::getBoss) 名 
.map(Manager : :getName)); (3) 





@ 0ptionaL<Department> 

@ Optional<Manager> 

@ 0ptionaL<String> 

接 下 来 ， 将 Company 也 包装 在 0ptional 中 ， 如 例 6-19 所 示 。 
例 6-19 在 Optional 的 Company 上 应 用 flatMap 


Optional<Company> Company = Optional.of(co); 





System.out.println( 


company 0 
.flatMap(Company: :getDepartment) @ 
.flatMap(Department: :getBoss) © 
.map(Manager : :getName) @ 


); 
@ 0ptionaL<Company> 
@ Optional<Department> 
@ Optional<Manager> 
@ Optional<String> 


不 难看 到 ， 我 们 甚至 可 以 将 Company 包装 在 Optional 中 ， 然 后 重复 执行 flatMap 操作 就 能 
获取 任何 所 需 的 属性 ， 最 后 通过 map 操作 结束 。 


























另 见 
有 关 在 0ptionat 中 包装 值 的 讨论 请 参见 范例 6.1， 昌 Stream.flatMap 方法 的 讨论 请 参见 
范例 3.11， 有 关 在 DAO 层 中 应 用 0ptional 的 讨论 请 参见 范例 6.3， 有 关 0ptional.map 方 


法 的 讨论 请 参见 范例 6.5。 
6.5 ”Optional 的 映射 


问题 

用 户 希 望 将 函数 应 用 到 0ptional 实例 的 集合 ， 但 前 提 是 0ptional 实例 包含 值 。 

方案 

使 用 0ptionat 类 定义 的 map 方法 。 

讨论 

假设 存在 一 个 包含 员工 了 D 值 的 列表 ， 我 们 希望 检索 相应 的 员工 实例 集合 。 如 果 
findEmployeeById 方法 具有 以 下 签名 ， 则 搜索 所 有 员工 后 将 返回 一 个 0ptional 实例 的 集 
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合 ， 其 中 某 些 实例 可 能 为 空 。 例 6-20 显示 了 如 何 筛 掉 为 空 的 0ptional。 
public Optional<Employee> findEmployeeById(int id) 
例 6-20 根据 ID 查找 Employee (使 用 Stream.map 方法 ) 


public List<Employee> findEmployeesByIds(List<Integer> ids) { 
return ids.stream() 


.map(this: :findEmployeeById) 0 
.filter(Optional::ispresent)) @ 
.map(Optional: :get) © 


.collect(Collectors.toList()); 


} 
©@ Stream<Optional<Employee>> 
@ 删除 空 的 0ptional 
@ 检索 确定 存在 的 值 
如 上 所 示 ， 第 一 个 map 操作 的 结果 是 一 个 由 0ptional 构成 的 流 ， 每 个 0ptional 要 么 包含 
一 名 员工 ， 要 么 为 空 。 为 提取 包含 的 值 ， 我 们 很 自然 会 想到 调用 get 方法 。 但 必须 注意 ， 
除非 确定 值 存在 ， 否 则 不 要 调用 get 方法 。 为 避免 出 现 错误 ， 我 们 采用 filter 方法 ， 它 传 
入 0ptional::isPresent 作为 谓词 以 删除 所 有 空 0ptional， 然 后 通过 第 二 个 map 操作 ( 传 
入 0ptional::get) 将 各 个 Optional 映射 到 它们 所 包含 的 值 。 
本 例 使 用 了 Strean 接口 定义 的 map 方法， 而 0ptional 类 同样 定义 有 map 方法 ， 其 签名 为 : 
<U> Optional<U> map(Function<? super T,? extends U> mapper) 
Optional.map 方法 传 入 Function 作为 参数 。 如 果 0ptional 不 为 空 ，map 方法 将 提取 包含 的 
值 并 应 用 给 定 的 函数 ， 然 后 返回 一 个 包含 结果 的 0ptionaL;， 如果 0ptional 为 空 ，map 方法 
将 返回 一 个 空 的 Optional。 
我 们 使 用 0ptional.map 方法 重 写 例 6-20 的 查找 操作 ， 结 果 如 例 6-21 所 示 。 
例 6-21 根据 ID 查找 Employee (使 用 0ptionaL.map 方法 ) 


public List<Employee> findEmployeesByIds(List<Integer> ids) { 
return ids.stream() 
















































































.map(this: :findEmployeeById) 0 
.flatMap(optional -> 
optional.map(Stream: :of) @ 


.OrElseGet(Stream::empty)) ©@ 
.collect(Collectors.toList()); 


} 
©@ Stream<Optional<Employee>> 
@ 将 非 空 Optional<Employee> 转换 为 Optional<Stream<Employee>> 
@ 从 0ptional 中 提取 Stream<Employee> 


如 果 包 含 员 工 的 0ptional 不 为 空 ， 则 在 包含 的 值 上 调用 Stream: :of ， 将 其 转换 为 该 值 的 一 
个 单元 素 流 (one-element stream) 并 包装 在 0ptional 中 ， 否 则 返回 一 个 空 的 Optional。 








在 本 例 中 ， 如 果 根 据 某 个 员工 ID 找到 了 相应 的 员工 ， 那 么 findEmployeeById 方法 将 返 
回 该 值 的 0ptionaL<EmpLoyee>，optionaL.map(Stream: :of) 方法 随后 返回 一 个 0ptional， 
它 包含 存储 该 员工 信息 的 单元 素 流 ， 由 此 得 到 0ptional<Stream<Employee>>。 接 下 来 ， 
orELseGet 方法 将 包含 的 值 提取 出 来 ， 生 成 Stream<EmpLoyee>。 

如 果 findEmpLoyeeById 方法 返回 为 空 的 0ptional，optional.map(Stream::of) 方法 同样 将 
返回 一 个 空 的 0ptionaL， 而 orELseGet(Stream: :empty) 方法 将 返回 一 个 空 的 流 。 


由 此 得 到 Stream<Employee> 元 素 与 空 流 的 组 合 ，Stream.flatMap 方法 的 真正 用 途 就 在 于 
此 。 仅 对 非 空 流 而 言 ，Stream.flatMap 方法 将 所 有 内 容 简 化 为 Stream<Employee>， 因 此 
collect 方法 可 以 将 非 空 流 作为 员工 列表 返回 。 


相应 的 过 程 如 图 6-1 所 示 。 























Stream 


.map(this::findEmployeesById) 


Stream 


Optional[E] Optional[E)] Optional.empty Optional[E,] 


opt -> opt.map(Stream: :of) 


.orElseGet(Stream: :empty) 


Stream 


Stream[E] Stream[E,] Stream[E,] 


flatMap 


Stream 


6-1: Optional.map 和 0ptional.flatMap 操作 














Optional.map 是 一 种 或 许 有 助 于 简化 流 处 理 代 码 的 便捷 ”方法 。 对 不 熟悉 flatMap 操作 的 开 
发 人 员 而 言 ， 之 前 讨论 的 filter/map 方案 显然 更 为 直观 ， 且 得 到 的 结果 并 无 二 致 。 

当然 ， 我 们 可 以 在 Optional.map 方法 中 使 用 任何 所 需 的 函数 。Javadoc 详细 描述 了 如 何 将 
名 称 转换 为 文件 输入 流 ， 其 他 应 用 请 参见 范例 6.4。 

此 外 ，Java 9 为 Optional 类 引入 了 一 个 名 为 strean 的 新 方法 。 如 果 0ptional 不 为 空 ， 
strean 方法 将 返回 一 个 包装 包含 值 的 单元 素 流 ， 否 则 返回 一 个 空 流 。 详 见 范 例 10.6。 






































注 5: 至 少 其 设计 思路 如 此 。 
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另 见 

有 关 0ptional 在 DAO 层 中 的 应 用 请 参见 范例 6.3， 有 关 Stream.flatMap 方法 的 讨论 请 参 
见 范例 3.11， 有 关 0ptional.flatMap 方法 的 讨论 请 参见 范例 6.4， 有 关 Java 9 为 Optional 
类 引入 的 新 方法 请 参见 范例 10.6。 











第 7 章 


文件 1/0 





J2SE 1.4 引入 了 NIO (non-blocking input/output， 非 阻塞 输入 /输出 ) 包 ',“N” 有 了 时 也 表 
示 “ 新 ”(new)。 而 Java 7 新 增 的 NIO.2 是 对 NIO 的 扩展 ， 它 定义 了 各 种 用 于 操作 文件 和 
目录 的 类 。NIO.2 包括 java.nio.file 包 ， 本 章 将 对 此 讨论 。Java 8 对 其 中 的 一 些 类 (如 
java.nio.files.File) 进行 强化 ， 引 入 了 若干 用 于 处 理 流 的 方法 。 

遗憾 的 是 ， 函 数 式 编程 所 倡导 的 流 式 隐 喻 和 输入 /输出 的 同一 术语 相互 冲突 ， 这 可 能 使 用 
户 感到 困惑 。 例 如 ，java.nio.file.DirectoryStreanm 接口 与 函数 式 流 (functional stream) 
无 关 ， 该 接口 由 使 用 传统 for-each 构造 对 目录 树 迭 代 的 类 来 实现 ”。 


这 一 章 将 重点 讨论 支持 函数 式 流 的 IO 功能 。Java 8 为 java.nio.file.Files 类 引入 了 若干 
用 于 处 理 函 数 式 流 的 新 方法 ， 这 些 方法 如 表 7-1 所 示 。 请 注意 ，Files 类 中 的 所 有 方法 均 
为 静态 方法 。 


表 7-1: java.nio.file.Files 类 定义 的 返回 流 的 方法 
































方法 返回 类 型 
lines Stream<String> 
list Stream<Path> 
walk Stream<Path> 
find Stream<Path> 


这 一 章 的 范例 将 讨论 上 述 方法 。 





注 1: 大 部 分 Java 开发 人 员 都 惊讶 于 NIO 的 引入 是 如 此 之 早 。 
注 2: 更 令 人 困惑 的 是 ，Directorystream.Filter 接口 实际 上 属于 函数 式 接口 ， 尽 管 它 也 和 函数 式 流 无 关 。 
该 接口 仅 用 于 批准 目录 树 中 选 定 的 条 目 。 
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7.1 文件 处 理 


问题 
用 户 希 望 使 用 流 来 处 理 文本 文件 的 内 容 。 


方案 
使 用 java.io.BufferedReader 或 java.nio.file.Files 类 定义 的 静态 方法 Lines， 以 流 的 形 
式 返 回 文件 内 容 。 


讨论 
在 所 有 基于 FreeBSD 的 UNIX 系统 (包括 macOS) 中 ，/usr/share/dict/ 文件 夹 都 包含 《 韦 氏 
国际 英语 词典 (第 2 版 )》。 web2 文件 收录 了 大 约 23 万 个 单词 ， 每 个 单词 在 文件 中 占据 一 行 。 


假设 我 们 希望 查找 词典 中 最 长 的 10 个 单词 。 为 此 ， 我 们 首先 使 用 Files.lines 方法 ， 将 单 
词 作为 字符 串 流 进行 检索 ， 然 后 执行 nap、fitter 等 常规 的 流 处 理 操作 。 相 关 示 例如 例 7-1 
所 示 。 


例 7-1 在 web2 文件 中 查找 最 长 的 10 个 单词 
try (Stream<String> lines = Files.lines(Paths.get("/usr/share/dict/web2")) { 
lines.filter(s -> s.length() > 20) 
.Sorted(Comparator .comparingInt(String::Length).reversed()) 
.limit(10) 
.forEach(w -> System.out.printf("%s (%d)%n", w, w.length())); 
} catch (IOException e) { 
e.printStackTrace(); 


























} 


在 本 例 中 ，fitlter 方法 中 的 谓词 筛 掉 了 长 度 不 足 20 个 字符 的 单词 ，sorted 方法 按 长 度 对 
这 些 单词 做 降序 排序 ，Limit 方法 在 获取 前 10 个 单词 后 终止 程序 ， 然 后 打印 这 些 单 词 。 由 
于 流 是 在 try-with-resources 代码 块 中 打开 的 ， 当 try 代码 块 完 成 时 ， 系 统 将 自动 关闭 流 
与 词典 文件 。 











流 与 AutoCloseable 接口 


Stream 接口 继承 自 BaseStream， 而 它 是 AutoCloseable 的 子 接口 。 因 此 ， 可 以 在 Java7 
新 增 的 try-with-resources 代码 块 中 使 用 流 。try 代码 块 执 行 完毕 后 ， 系 统 将 自动 调用 
close 方法 。 它 不 仅 会 关闭 流 ， 还 会 调用 流 的 流水 线 (stream pipeline) 中 的 任何 close 
处 理 程序 以 释放 资源 。 

到 目前 为 止 ， 我 们 尚未 接触 try-with-resources 包装 器 ， 因 为 之 前 讨论 的 流 是 从 集合 
或 在 内 存 中 生成 的 。 而 在 本 范例 中 ， 流 是 基于 文件 的 ， 因 此 try-with-resources 能 确 
保 词 典 文件 也 被 关闭 。 














执行 例 7-1 中 的 代码 ， 结 果 如 例 7-2 所 示 。 
例 7-2 词典 中 最 长 的 10 个 单词 


formaLdehydesuLphoxyLate (24) 
pathologicopsychological (24) 
scientificophilosophical (24) 
tetraiodophenolphthalein (24) 
thyroparathyroidectomize (24) 
anthropomorphologically (23) 
blepharosphincterectomy (23) 
epididymodeferentectomy (23) 
formaldehydesulphoxylic (23) 
gastroenteroanastomosis (23) 


如 上 所 示 ， 词 典 中 有 5 个 单词 的 长 度 为 24 个 字符 。 结 果 之 所 以 按 字母 顺序 显示 ， 只 是 因 
为 原始 文件 中 的 单词 是 按 字母 顺序 排序 的 。 在 例 7-1 中 ， 如 果 为 sorted 方法 的 Comparator 
参数 添加 一 个 thenComparing 子 句 ， 就 能 调整 等 长 单词 的 排序 方式 了 。 


在 5 个 长 度 为 24 个 字符 的 单词 之 后 ， 是 5 个 长 度 为 23 个 字符 的 单词 ， 其 中 大 部 分 单词 来 
自 医学 领域 。 


如 果 将 Collectors.counting 作为 下 游 收集 器 ， 就 能 确定 词典 中 每 种 长 度 的 单词 数量 ， 如 
例 7-3 所 示 。 


例 7-3 确定 每 种 长 度 的 单词 数量 (升序 排序 ) 
try (Stream<String> lines = Files.lines(Paths.get("/usr/share/dict/web2"))) { 
lines.filter(s -> s.length() > 20) 
.Collect(Collectors.groupingBy(String::length, Collectors.counting())) 
.forEach((len, num) -> System.out.println(len + ": " + num)); 
































} 


上 述 代 码 使 用 收集 器 groupingBy 创建 一 个 Map， 其 中 键 为 单词 长 度 ， 值 为 每 种 长 度 的 单词 
数量 。 代 码 的 执行 结果 如 下 : 






































上 述 输出 虽然 提供 了 部 分 信息 ， 但 并 非特 别 有 用 。 且 结果 按 升序 排序 ， 这 也 可 能 不 满足 我 
们 的 要 求 。 

另 一 种 方案 是 采用 Map.Entry 接口 新 增 的 静态 方法 comparingByKey 和 comparingByVaLue， 
二 者 均 传 入 可 选 的 Comparator (相关 讨论 请 参见 范例 4.4)。 如 例 7-4 所 示 ， 通 过 比较 器 
reverse0rder 进行 排序 时 ， 将 返回 自然 顺序 的 相反 顺序 。 


例 7-4 确定 每 种 长 度 的 单词 数量 (降序 排序 ) 


try (Stream<String> lines = Files.lines(Paths.get("/usr/share/dict/web2"))) { 
Map<Integer, Long> map = lines.filter(s -> s.length() > 20) 


























注 3: 好 在 blepharosphincterectomy ( 眼 轮 熙 肌 切 除 术 ) 与 其 字面 意思 无 关 ， 这 是 一 个 与 减轻 角膜 上 有 眼 瞪 压 
力 有 关 的 单词 。 听 起 来 很 头疼 ? 其 实 可 能 更 头疼 。 
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.Collect(Collectors.groupingBy(String::length, Collectors.counting())); 


map.entrySet().stream() 
.sorted(Map.Entry.comparingByKey(Comparator .reverseOrder())) 
.forEach(e -> System.out.printf("Length %d: %d words%n", 
e.getKey(), e.getValue())); 
} 


程序 的 执行 结果 如 下 : 


Length 24: 5 words 
Length 23: 17 words 
Length 22: 41 words 
Length 21: 82 words 


如 果 数 据 源 不 是 文件 ， 也 可 以 使 用 BufferedReader 类 新 增 的 Lines 方法 (这 种 情况 下 ，Lines 
是 一 个 实例 方法 )。 采 用 BufferedReader .Lines 方法 对 例 7-4 改写 ， 结 果 如 例 7-5 所 示 。 


例 7-5 BufferedReader.lines 方法 的 应 用 
try (Stream<String> lines = 
new BufferedReader( 
new FileReader("/usr/share/dict/words")).lines()) { 























// 其余 代码 与 例 7-4 相 同 
由 


需要 再 次 强调 的 是 ， 由 于 Strean 接口 实现 了 AutoCloseable 接口 ， 当 try-with-resources 
代码 块 关闭 流 时 ， 底 层 BufferedReader 也 随 之 关闭 。 














另 见 
有 关 对 映射 排序 的 讨论 请 参见 范例 4.4。 


7.2 ”以 流 的 形式 检索 文件 


问题 
用 户 希望 将 目录 中 的 所 有 文件 作为 Strean 进行 处 理 。 
方案 


使 用 java.nio.file.Files 类 定义 的 静态 方法 list。 




















讨论 
List 方法 传 入 Path 作为 参数 ,并 返回 一 个 包装 DirectoryStream 的 Stream。 由 于 DirectoryStream 





注 4: 这 是 一 个 IO 流 而 非 函 数 式 流 。 





接口 继承 自 AutoCloseable，try-with-resources 构造 是 使 用 List 方法 的 最 佳 方式 ， 如 
例 7-6 所 示 。 


例 7-6 Files.list(path) 方法 的 应 用 


try (Stream<Path> list = Files.list(Paths.get("src/main/java"))) { 
list.forEach(System.out: :println); 

} catch (IOException e) { 
e.printStackTrace(); 


} 


如 果 在 具有 标准 Maven 或 Gradle 结构 的 项 目 根 目录 下 执行 上 述 代码 ， 程 序 将 打印 src/ 
main/java 目录 中 所 有 文件 和 文件 夹 的 名 称 。 使 用 try-with-resources 代码 块 ， 当 try 代码 
块 执行 完毕 后 ， 系 统 将 在 Stream 上 调用 close 方法 ， 然 后 在 底层 DirectoryStream 上 调用 
close 方法 。 请 注意 ， 目 录 和 文件 不 是 递归 的 。 


执 和 














本 书 配套 的 源 代码 ( 例 7-6) ， 程 序 将 输出 目录 和 单个 文件 ， 


src/main/java/collectors 
src/main/java/concurrency 
src/main/java/datetime 








src/main/java/Summarizing.java 
src/main/java/tasks 
src/main/java/UseFilenameFilter.java 











list 方法 的 签名 如 下 ， 其 返回 类 型 为 Stream<Path>， 人 参数 为 目录 的 路 径 : 





public static Stream<Path> list(Path dir) throws IOException 





请 注意 ， 对 非 目 录 资 源 执行 List 方法 将 抛 出 NotDirectoryException。 


Javadoc 指出 ，list 方法 返回 的 流 具 备 弱 一 致 性 (weak consistency)。 换 言 之 ,“ 流 是 线程 
安全 的 ， 但 在 迭代 时 不 会 冻结 目录 ， 因 此 它 可 能 会 (也 可 能 不 会 ) 反映 tist 方法 返回 后 


























发 生 的 目录 更 新 ”。 





另 见 
有 关 采 用 深度 优先 搜索 遍历 文件 系统 的 讨论 请 参见 范例 7.3。 


7.3 文件 系统 的 遍历 





问题 
用 户 希望 对 文件 系统 进行 深度 优先 遍历 (depth-first traversal ) 。 





方案 


使 用 java.nio.file.Files 类 定义 的 静态 方法 walk。 
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* * 八 
讨论 
walk 方法 的 签名 如 下 : 
public static Stream<Path> walk(Path start, 


FileVisitOption... options) 
throws IOException 


walk 方法 的 参数 为 起 始 Path 以 及 Filevisitoption 值 的 可 变 参数 列表 。 从 起 始 路 径 开 始 对 
文件 系统 执行 深度 优先 遍历 ， 返 回 一 个 由 Path 实例 惰性 填充 的 Stream。 


由 于 返回 的 Stream 封装 了 DirectoryStream， 仍 然 建议 在 try-with-resources 代码 块 中 使 
用 watk 方法 ， 如 例 7-7 所 示 。 


例 7-7 文件 树 的 遍历 
try (Stream<Path> paths = Files.walk(Paths.get("src/main/java"))) { 
paths.forEach(System.out::printtLn); 
} catch (IOException e) { 
e.printStackTrace(); 











} 


walk 方法 传人 零 个 或 多 个 Filevisitoption 值 作为 第 二 个 参数 以 及 后 续 参 数 ， 不 过 本 例 并 未 
使 用 任何 FiLevisitoption 值 。FilevisitOption 是 Java 1.7 引入 的 一 种 枚 举 类 型 ， 所 包含 的 
唯一 枚 举 常 量 为 FOLLOW_LINKS。 至 少 从 理论 上 说 ，FOLLOW_LINKS 意味 着 文件 树 中 可 能 存在 循 
环 ， 因 此 流 将 跟踪 所 访问 的 文件 。 一 旦 检测 到 循环 ， 程 序 将 抛 出 FileSystemLoopException。 


执行 本 书 配套 的 源 代码 ( 例 7-7) ， 输 出 类 似 于 : 


src/main/java 

src/main/java/collectors 
src/main/java/collectors/Actor .java 
src/main/java/collectors/AddCollectionToMap.java 
src/main/java/collectors/Book.java 
src/main/java/collectors/CollectorsDemo.java 
src/main/java/collectors/ImmutableCollections.java 
src/main/java/collectors/Movie.java 
src/main/java/collectors/MysteryMen.java 
src/main/java/concurrency 
src/main/java/concurrency/CommonPoolSize.java 
src/main/java/concurrency/CompletableFutureDemos. java 
src/main/java/concurrency/FutureDemo.java 
src/main/java/concurrency/ParallelDemo.java 
src/main/java/concurrency/SequentialToParallel.java 
src/main/java/concurrency/Timer .java 
src/main/java/datetime 























程序 采用 惰性 方式 遍历 路 径 ， 所 生成 的 流 必然 包含 至 少 一 个 元 素 (起 始 参数 )。 对 于 遇 到 
的 每 条 路 径 ， 程 序 将 判断 它 是 否 为 目录 ， 是 则 遍历 其 中 的 所 有 条 目 ， 然 后 移动 到 下 一 个 同 
级 元 素 (sibling)。 其 结果 是 一 种 深度 优先 遍历 。 程 序 访问 每 个 目录 包含 的 所 有 条 目 之 后 ， 
将 关闭 该 目录 。 


























walk 方法 还 包括 以 下 重 载 形式 : 


public static Stream<Path> walk(Path start, 
int maxDepth, 
FileVisitOption... options) 
throws IOException 


甚 中， 参数 maxDepth 是 要 访问 的 目录 级 别 的 最 大 值 ，0 表示 只 访问 起 始 文件 。 如 果 不 使 用 
maxDepth， 可 以 通过 Integer .MAX_VALUE 值 来 指定 应 访问 所 有 级 别 。 
































品 见 
力作 
有 关 如 何 列 出 一 个 目录 中 的 所 有 文件 请 参见 范例 7.2， 有 基文 件 搜索 的 讨论 请 参见 范例 7.4。 


7.4 文件 系统 的 搜索 


问题 
用 户 希 望 查找 文件 树 中 满足 给 定 属性 的 文件 。 


方案 


使 用 java.nio.file.Files 类 定义 的 静态 方法 find。 


外 * 
讨论 
find 方法 的 签名 如 下 : 
public static Stream<Path> find(Path start, 
int maxDepth, 
Bipredicate<Path, BasicFileAttributes> matcher, 


FileVisitOption... options) 
throws IOException 


可 以 看 到 ，find 方 法 的 签名 与 watk 方法 类 似 ， 但 增加 了 一 个 用 于 决定 是 否 应 返回 特 
定 Path 的 匹配 器 Bipredicate。find 方 法 从 给 定 路 径 开始 执行 深度 优先 搜索 (depth- 
first search) ， 直 至 达到 maxDepth 指定 的 目录 级 别 。 对 于 每 条 路 径 ，fiind 方法 都 会 调用 
Bipredicate 进行 评估 。 如 果 指 定 为 Filevisitoption 枚 举 的 值 ， 则 执行 后 面 的 链接 。 


Bipredicate 需要 根据 每 个 路 径 元 素 及 其 关联 的 BasicFileAttributes 对 象 返 回 布尔 值 。 如 
例 7-8 所 示 ， 程 序 将 返回 fileio 包 (参见 本 书 配套 源 代码 ) 中 所 有 非 目 录 文 件 的 路 径 。 


例 7-8 查找 fileio 包 中 的 非 目 录 文 件 
try (Stream<Path> paths = 
Files.find(Paths.get("src/main/java"), Integer .MAX_VALUE, 
(path, attributes) -> 
lattributes.isDirectory() && path.toString().contains("fileio"))) { 
paths.forEach(System.out::println); 
} catch (IOException e) { 
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e.printStackTrace(); 


} 
输出 结果 如 下 : 


src/main/java/fileio/FilelList.java 
src/main/java/fileio/ProcessDictionary.java 
src/main/java/fileio/SearchForFiles.java 
src/main/java/fileio/WalkTheTree.java 


对 于 遍历 文件 树 时 直到 的 每 一 个 文件 ，find 方法 都 会 根据 给 定 的 Bipredicate 进行 评估 ， 
类 似 于 在 watk 方法 返回 的 Strean 上 调用 筛选 器 。 不 过 ，Javadoc 认为 find 方法 避免 了 对 
BasicFileAttributes 对 象 的 宛 余 检索 ， 因 而 能 提高 程序 的 效率 。 


类 似 地 ， 由 于 返回 的 Stream 封装 了 DirectoryStream， 在 关闭 流 的 同时 ， 底 层 数 据 源 也 随 
之 关闭 。 有 鉴于 此 ， 在 try-with-resources 代码 块 中 使 用 find 方法 是 首选 方案 。 























另 见 
有 关 文 件 系统 的 遍历 请 参见 范例 7.3。 
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第 8 和 章 


java .time 包 





将 java.util.Date 类 束之高阁 才 是 正确 之 道 。 





Tim Yates 


在 Java 面世 之 初 ， 标 准 库 就 引入 了 两 种 用 于 处 理 日 期 和 时 间 的 类 ， 它 们 是 java.util.Date 
和 java.util.Calendar， 而 前 者 堪 称 类 糟糕 设计 的 典范 。 浏 览 API 可 以 发 现 ， 从 Java 1.1 
(1997 年 2 月 发 布 ) 开始 ，Date 类 中 的 所 有 方法 就 已 被 弃 用 。Java 1.1 推荐 采用 Calendar 
类 处 理 日 斯 和 时 间 ， 但 这 个 类 同样 存在 不 少 问 题 。 


在 Java 引入 java.util.Date 和 java.util.Calendar 类 之 前 ， 枚 举 类 型 (enum) 尚未 出 
现 ， 所 以 两 种 类 在 字段 (如 月 份 ) 中 使 用 整 型 常量 。 两 种 类 都 是 可 变 的 ， 因 而 不 是 线程 安 
全 (thread safe) 的 。 为 处 理 实际 开发 中 遇 到 的 问题 ， 标 准 库 随后 引入 java.sql.Date 作为 
java.util.Date 的 子 类 ， 但 仍然 没 能 彻底 解决 问题 。 


最 终 ，Java SE 8 引入 java.time 包 ， 这 个 全 新 的 包 从 根本 上 解决 了 长 久 以 来 存在 的 诸多 次 
端 。java.time 包 基 于 Joda-Time 库 构 建 ， 它 是 一 种 免费 的 开源 解决 方案 ， 多 年 来 一 直 作为 
处 理 Java 日 期 和 时 间 的 事实 标准 。 实 际 上 ，Joda-Time 库 的 设计 团队 也 参与 了 java.time 
包 的 开发 ， 并 建议 开发 人 员 在 今后 的 工作 中 使 用 它 。 

java.time 包 的 开发 遵循 JSR 310 规范 (Date-Time API) ， 并 支持 ISO 8601 标准 ， 且 对 头 
年 和 个 别 地 区 实行 的 夏 时 制 规则 做 了 相应 的 调整 。 


这 一 章 的 范例 将 展示 java.time 包 的 各 种 应 用 ， 和 希望 有 助 于 解决 读者 可 能 遇 到 的 某 些 基本 
问题 ， 并 在 需要 时 提供 进一步 的 信息 。 

感 兴趣 的 读者 可 以 阅读 Java 官方 教程 (Java Tutorials) 中 有 关 Date-Time API 的 介绍 ， 它 
提供 了 系统 而 详尽 的 信息 。 
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8.1 Date-Time API 中 的 基本 类 


问题 
用 户 希 望 使 用 java.time 包 引入 的 类 来 处 理 日 期 和 时 间 。 
使 用 Instant、Duration、Period、LocalDate、LocalTime、LocalDateTime、ZonedDateTime 


等 类 定义 的 工厂 方法 。 


讨论 
Date-Time API 中 的 所 有 类 均 生 成 不 可 变 实例 ， 它 们 是 线程 安全 的 。 由 于 这 些 类 不 提供 公 
共 构 造 函 数 (public constructor) ， 需 要 采用 工厂 方法 加 以 实例 化 。 

读者 应 对 now 和 of 这 两 种 静态 工厂 方法 予以 特别 注意 。now 方法 根据 当前 日 期 或 时 间 创 建 
实例 ， 示 例 代 码 如 例 8-1 所 示 。 

例 8-1 工厂 方法 now 
System.out.printLn("Instant.now() : 
System.out.printLn("LocaLDate.now() : 
System.out.printLn("LocaLTime.now() : 


System.out.printLn("LocaLDateTime .now() : 
System.out.printLn("ZonedDateTime .now() : 


上 述 代码 的 输出 如 例 8-2 所 示 。 
例 8-2 调用 now 方法 的 结果 








Instant.now()); 
LocalDate.now()); 
LocalTime.now()); 
LocalDateTime.now()); 
ZonedDateTime .now() ) ; 


+ + + + + 





Instant.now(): 2017-06-20T17:27:08.184Z 
LocalDate.now(): 2017-06-20 
LocalTime.now(): 13:27:08.318 


LocalDateTime.now(): 2017-06-20T13:27:08.319 
ZonedDateTime.now(): 2017-06-20T13:27:08.319-04:00[America/New_York] 


如 例 8-2 所 示 ， 所 有 输出 值 均 使 用 ISO 8601 标准 格式 。 日 期 的 基本 格式 为 yyyy-MM-dd， 而 
时 间 的 基本 格式 为 hh:mm:ss.sss。LocalDateTime 类 将 两 种 格式 合 二 为 一 ， 中 间 用 大 写字 
T 隔 开 。zonedDateTime 类 用 于 显示 包含 时 区 信息 的 日 期 和 时 间 ， 其 后 添加 了 一 个 UTC 
偏 移 量 (UTC offset) 以 及 一 个 地 区 名 (region name) ， 本 例 分 别 为 -04:00 和 America/New_ 
York。 此 外 ，Instant 类 定义 的 tostring 方法 将 输出 以 祖 鲁 时 间 (Zulu time) “显示 的 当前 
时 间 (精确 到 纳 秒 )。 


类 似 地 ，Year、YearMonth 与 MonthDay 类 也 定义 了 now 方法 。 
































注 1: 即 UTC 时 间 ， 因 为 北约 音标 字母 (NATO phonetic alphabet) 采用 “Zulu” 表 示 “Z”， 而 “Z” 在 
UTC 中 表示 零 时 区 。 例 如 ,“03:06 UTC” 可 以 表示 为 “03:06Z”(“03:06” 和 “2Z” 之 间 没 有 空格 )。 
一 一 译 者 注 
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静态 工厂 方法 of 用 于 生成 新 的 值 。 对 LocalDate 类 而 言 ，of 方法 的 参数 为 年 、 月 〈 枚 举 
或 整 型 ) 、 日 。 





所 有 of 方法 的 月 份 字 段 经 过 重 载 ， 以 接受 Month 枚 举 (如 Month.JANUARY) 
或 起 始 值 为 1 的 整数 。 不 过 ， 由 于 java.util.Calendar 类 定义 的 整 型 常量 从 
0 开始 ( 即 Calendar.JANUARY 为 0) ， 需 注意 避免 出 现 差 一 错误 (off-by-one 
error)。 如 有 可 能 ， 应 尽量 使 用 Month 枚 举 。 

















LocalTime 类 定义 的 of 方法 包括 多 种 重 载 形 式 ， 根 据 可 用 的 小 时 、 分 、 秒 以 及 纳 秒 值 获取 
当前 日 期 。LocalDateTime 类 定义 的 of 方法 同 宰 包 括 乡 种 重 雪 开 无 ， 根据 可 用 的 年 、 月 、 
日 、 小 时 、 分 、 秒 以 及 纳 秒 值 获取 当前 日 期 和 时 间 。 相 关 应 用 如 例 8-3 所 示 。 


例 8-3 of 方法 在 日 期 /时 间 类 中 的 应 用 
System.out.println("First landing on the Moon:"); 
LocalDate moonLandingDate = LocalDate.of(1969, Month.JULY, 20); 
LocalTime moonLandingTime = LocalTime.of(20, 18); 
System.out.println("Date: " + moonLandingDate); 
System.out.println("Time: " + moonLandingTime); 





System.out.println("Neil Armstrong steps onto the surface: "); 
LocalTime walkTime = LocalTime.of(20, 2, 56, 150_000_000); 
LocalDateTime walk = LocalDateTime.of(moonLandingDate, walkTinme); 
System.out.println(walk); 


输出 如 下 : 


First landing on the Moon: 

Date: 1969-07-20 

Time: 20:18 

Neil Armstrong steps onto the surface: 

1969-07-20T20:02:56.150 
LocalTime.of 方法 的 最 后 一 个 参数 是 纳 秒 。 本 例 在 数值 中 使 用 下 划 线 以 增强 可 读 性 ， 这 是 
Java7 引入 的 一 个 特性 。 


Instant 类 对 时 间 轴 上 的 单一 瞬时 点 (single instantaneous point) 建 模 ， 可 以 用 于 记录 应 用 
程序 中 的 事件 时 间 惟 。 


ZonedDateTime 类 将 日 期 和 时 间 与 通过 zoneId 类 获取 的 时 区 信息 结合 在 一 起 ， 时 区 以 UTC 
偏 移 量 的 形式 表示 。 


时 区 ID 包括 两 种 类 型 。 


。 相对 于 UTC/ 格林 尼 治 标准 时 间 的 固定 偏 移 量 (fixed offset) ， 如 -05:06。 
。 地 理 区域 (geographical region) ， 如 America/Chicago。 
严格 来 说 ， 还 存在 第 三 种 时 区 ID， 即 相对 于 祖 鲁 时 间 的 偏 移 量 ， 它 由 z 和 相应 的 数值 构成 。 


java.time.zone.ZoneRules 类 定义 了 调整 偏 移 量 的 规则 ， 这 些 规 则 通过 java.time.zone. 
ZoneRulesProvider 类 载 入 。ZzoneRutLes 类 包括 isDaylightsavings(Instant) 等 方法 。 
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静态 方法 systemDefautt 用 于 获取 系统 默认 时 区 (zoneId 的 当前 值 )， 而 可 用 时 区 ID 的 完 
整 列 表 由 静态 方法 getAvailableZzoneIds 提供 : 


Set<String> regionNames = Zoneld.getAvailableZoneIds(); 
System.out.println("There are " + regionNames.size() + 


以 jdk1.8.0_131 为 例 ， 它 包括 600 个 地 区 名 ”。 


Date-Time API 使 用 方法 名 的 标准 前 级 。 如 果 读 者 熟悉 表 8-1 列 出 的 前 级 ， 不 难 猿 出 相应 方 
法 的 用 途 。” 


表 8-1: Date-Time API 中 各 种 方法 所 用 的 前 缀 

















region names"); 





































































































方法 类 型 用 途 

of 静态 工 创建 实例 

from 静态 工 将 输入 参数 转换 为 目标 类 (target class) 的 实例 
parse 静态 工 解析 输入 字符 串 

format 实例 生成 格式 化 输出 

get 实例 返回 对 象 状态 的 一 部 分 

is 实例 查询 对 象 状态 

with 实例 通过 修改 现 有 对 象 的 某 个 元 素来 创建 新 对 象 
plus, minus 实例 分 别 通过 现 有 对 象 的 增 减 来 创建 新 对 象 

to 实例 将 对 象 转换 为 另 一 种 类 型 

at 实例 将 对 象 与 另 一 个 对 象 合并 


前 面 已 讨论 过 of 方法 ， 有 关 parse 和 format 方法 的 讨论 请 参见 范例 8.5， 有 关 with 方法 
的 讨论 请 参见 范例 8.2， 它 是 set 方法 的 不 可 变 等 效 形式 ， 有 关 plus 和 minus 方法 的 应 用 
请 参见 范例 8.2。 


例 8-4 显示 了 利用 at 方法 为 本 地 日 期 和 时 间 添 加 时 区 。 
例 8-4 为 LocaLDateTime 添加 时 区 信息 


LocalDateTime dateTime = LocalDateTime.of(2017, Month.JULY, 4, 13, 20, 10); 
ZonedDateTime nyc = dateTime.atZone(ZoneId.of("America/New_ York'" )); 
System.out.println(nyc); 


ZonedDateTime London = nyc.wWithZoneSameInstant(ZoneId.of("Europe/London'" ) ); 
System.out.printLn(London); 


输出 结果 如 下 : 


2017-07-04T13:20:10-04:00[America/New_York] 
2017-07-04T18:20:10+01:00[Europe/London] 


在 本 例 中 ，withzoneSameInstant 方法 传人 一 个 ZonedDateTime， 并 查找 另 一 个 时 区 的 日 期 
和 时 间 。 











注 2: 或 许 不 只 作者 感觉 地 区 名 的 数量 是 如 此 之 多 。 
注 3: 根据 Java 官方 教程 提供 的 常用 前 级 表格 编写 。 











java.time 包 引 入 了 Month 和 DayofwWeek 两 种 枚 举 。Month 包括 标准 日 历 中 12 个 月 份 的 常量 
(从 JANUARY 到 DECEMBER) ， 也 定义 了 许多 便利 的 方法 ， 如 例 8-5 所 示 。 


例 8-5 Month 枚 举 定义 的 部 分 方法 
System.out.printLn("Days in Feb in a leap year: "+ 
Month .FEBRUARY .Length(true) ) ; 0 
System.out.println("Day of year for first day of Aug (leap year): "+ 
Month .AUGUST.firstDayOfYear(true)); ©@ 
System.out.println("Month.of(1): " + Month.of(1)); 
System.out.println("Adding two months: " + Month.JANUARY.plus(2)); 
System.out.println("Subtracting a month: " + Month.MARCH.minus(1)); 


并 





@ 参数 为 boolean LeapYear 
输出 如 下 : 


Days in Feb in a leap year: 29 

Day of year for first day of Aug (leap year): 214 
Month.of(1): JANUARY 

Adding two months: MARCH 

Subtracting a month: FEBRUARY 


在 本 例 中 ， 最 后 两 条 语句 分 别 使 用 plus 和 minus 方法 创建 了 新 的 实例 。 





java.time 包 中 的 类 是 不 可 变 的 ， 如 果实 例 方法 (如 plus、minus 或 with) 试 
辐 修改 某 个 类 ， 将 生成 一 个 新 的 实例 。 

















DayofWeek 枚 举 包括 表示 7 个 工作 日 的 常量 (从 MONDAY 到 SUNDAY)。 所 有 工作 日 的 int 值 均 
遵循 ISO 标准 ， 因 此 MONDAY 为 1，SUNDAY 为 7。 








吕 由 

力作 

有 关 解 析 和 格式 化 的 讨论 请 参见 范例 8.5， 有 关 将 现 有 日 期 和 时 间 转 换 为 新 的 日 期 和 时 间 
请 参见 范例 8.2， 有 关 Duration 和 Period 类 的 应 用 请 参见 范例 8.8。 


8.2 ”根据 现 有 实例 创建 日 期 和 时 间 
问题 
用 户 希 望 修改 Date-Time API 中 某 个 类 的 现 有 实例 。 


方案 


如 有 果 需 要 进行 简单 的 增 减 操作 ， 使 用 plus 或 minus 方法 ， 对 于 其 他 操作 ， 使 用 with 方法 。 
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讨论 

Date-Time API 中 的 所 有 实例 都 是 不 可 变 的 。 一 旦 创建 LocaLDate、LocaLTime、LocaLDateTime 
或 zonedDateTime， 就 无 法 修改 它们 。 这 对 保持 线程 安全 而 言 十 分 有 利 ， 不 过 如 何 根据 现 
有 实例 创建 新 的 实例 呢 ? 

以 LocalDate 类 为 例 ， 它 定义 了 多 种 对 日 期 进行 增 减 操 作 的 方法 ， 包 括 : 

。 LocalDate plusDays(long daysToAdd) 

。 LocalDate plusWeeks(long weeksToAdd) 


。 LocalDate plusMonths(long monthsToAdd) 
。 LocalDate plusYears(long yearsToAdd) 


上 述 方法 均 返 回 一 个 新 的 LocalDate， 它 是 当前 日 期 的 副本 ， 并 添加 了 指定 的 
LocalTime 类 也 定义 了 类 似 的 方法 : 


。 LocalTime plusNanos(long nanosToAdd) 











TI 

















。 LocalTime plusSeconds(long secondsToAdd ) 
。 LocalTime plusMinutes(long minutesToAdd) 


。 LocalTime plusHours(long hoursToAdd) 


类 似 地 ， 每 种 方法 均 返 回 一 个 新 的 LocalTime， 它 是 当前 时 间 的 副本 ， 并 添加 了 指定 的 值 。 
此 外 ，LocalDateTime 类 囊括 了 LocalDate 和 LocaLTime 类 中 用 于 处 理 日 期 和 时 间 增 减 的 所 
有 方法 。 例 8-6 显示 了 各 种 plus 方法 在 LocalDate 和 LocalTime 类 中 的 应 用 。 


例 8-6 plus 方法 在 LocalDate 和 LocalTime 类 中 的 应 用 
@Test 
public void LocaLDatePLus() throws Exception { 
DateTimeFormatter formatter = DateTimeFormatter .ofPattern("yyyy-MM-dd" ); 
LocalDate start = LocalDate.of(2017, Month.FEBRUARY, 2); 











LocalDate end = start.plusDays(3); 
assertEquals("2017-02-05", end.format(formatter)); 


end = start.plusWeeks(5); 
assertEquals("2017-03-09", end.format(formatter)); 


end = start.plusMonths(7); 
assertEquals("2017-09-02", end.format(formatter)); 


end = start.plusYears(2); 
assertEquals("2019-02-02", end.format(formatter)); 


} 


@Test 
public void LocaLTimePLus() throws Exception { 
DateTimeFormatter formatter = DateTimeFormatter .1ISO_ LOCAL_TIME; 


LocalTime start = LocalTime.of(11, 30, 0, 0); 
LocalTime end = start.plusNanos(1_000_000); 
assertEquals("11:30:00.001", end.format(formatter)); 





大 
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end = start.plusSeconds(20); 
assertEquals("11:30:20", end.format(formatter)); 


end = start.plusMinutes(45); 
assertEquals("12:15:00", end.format(formatter)); 


end = start.plusHours(5); 
assertEquals("16:30:00", end.format(formatter)); 
} 


不 少 类 还 包括 其 他 两 种 形式 的 plus 和 minus 方 法。 以 LocalDateTime 类 为 例 ，plus 和 
minus 方法 的 签名 如 下 : 


LocalDateTime plus(long amountToAdd, TemporalUnit unit) 
LocalDateTime plus(TemporalAmount amountToAdd) 














LocalDateTime minus(long amountToSubtract, TemporalUnit unit) 
LocalDateTime minus(TemporalAmount amountToSubtract) 


对 于 LocalDate 和 LocalDate 类 ，plus 和 minus 方法 的 格式 与 LocalDateTime 类 相同 ， 具 有 
相应 的 返回 类 型 。 有 趣 的 是 ， 不 妨 将 minus 方法 视 为 具有 否定 形式 的 plus 方法 。 
对 传 入 TemporalAmount 的 方法 而 言 ， 参 数 通常 为 Period 或 Duration， 但 也 可 以 是 任何 实 
现 TemporaLAmount 接口 的 类 型 。 该 接口 定义 了 addTo 和 subtractFrom 两 种 方法 : 


Temporal addTo(Temporal temporal) 
Temporal subtractFrom(Temporal temporal) 


跟踪 调用 栈 (call stack) 可 以 看 到 ， 调 用 minus 委托 给 带 有 否定 参数 的 plus ， 而 plus 委托 
给 TemporalAmount.addTo(Temporal)，TemporalAmount.addTo(Temporal) 再 回调 pLus(Long， 


TemporaLUnit)， 它 将 执行 实际 的 操作 “。 
例 8-7 显示 了 plus 和 minus 方法 的 相关 应 用 。 
例 8-7 plus 和 minus 方法 的 应 用 


QTest 

public void plus_minus() throws Exception { 
Period period = Period.of(2，3，4); // 两 年 3 个 月 零 4 天 
LocalDateTime start = LocalDateTime.of(2017, Month.FEBRUARY, 2, 11, 30); 
LocalDateTime end = start.plus(period); 








assertEquals("2019-05-06T11:30:00"， 
end.format(DateTimeFormatter .ISO_LOCAL_DATE_TINME) ) ; 


end = start.plus(3, ChronoUnit.HALF_DAYS); 
assertEquaLs("2017-02-03T23:30:00" ， 
end.format(DateTimeFormatter .ISO0_LOCAL_DATE_TINME) ) ; 


end = start.minus(period); 
assertEquals("2014-10-29T11:30:00"， 
end.format(DateTimeFormatter .1SO_LOCAL_DATE_TIME)); 





注 4: 老 天 ， 多 么 间接 的 操作 |! 
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end = start.minus(2, ChronoUnit.CENTURIES); 
assertEquaLs("1817-02-02T11:30:00" ， 
end.format(DateTimeFormatter .ISO0_LOCAL_DATE_TINME) ) ; 


end = start.plus(3, ChronoUnit.MILLENNIA); 
assertEquals("5017-02-02T11:30:00", 
end.format(DateTimeFormatter .ISO_LOCAL_DATE_TIME)); 


当 API 调用 TemporalUnit 时 ， 提 供 的 实现 类 为 chronounit， 它 定义 了 许多 方 
便 的 枚 举 常量 (enum constant) 可 供 使 用 。 


此 外 ， 每 种 类 都 定义 了 一 系列 with 方法 ， 可 以 一 次 修改 一 个 字段 。 
with 方法 用 于 处 理 常 用 的 日 期 和 时 间 ， 某 些 方法 颇 为 有 趣 。 以 LocalDateTime 类 为 例 : 


LocalDateTime withNano(int nano0fSecond) 
LocalDateTime withSecond(int second) 
LocalDateTime withMinute(int minute) 
LocalDateTime withHour(int hour) 
LocalDateTime withDayOfMonth(int dayOfMonth) 
LocalDateTime WiLthDayOfYear(int dayOfYear) 
LocalDateTime withMonth(int month) 
LocalDateTime withYear(int year) 


例 8-8 显示 了 各 种 with 方法 的 应 用 。 
例 8-8 with 方法 在 LocalDateTime 类 中 的 应 用 


@Test 
public void with() throws Exception { 
LocalDateTime start = LocalDateTime.of(2017, Month.FEBRUARY, 2, 11, 30); 
LocalDateTime end = start.withMinute(45); 
assertEquaLs("2017-02-02T11:45:00"， 
end.format(DateTimeFormatter .ISO0_LOCAL_DATE_TINME) ) ; 

















end = start.withHour(16); 
assertEquals("2017-02-02T16:30:00"，, 
end.format(DateTimeFormatter .1SO_LOCAL_DATE_TIME)); 


end = start.withDayofMonth(28); 
assertEquals("2017-02-28T11:30:00", 
end.format(DateTimeFormatter .ISO_LOCAL_DATE_TINME) ) ; 


end = start.withDayOfYear(300); 
assertEquaLs("2017-10-27T11:30:00"， 
end.format(DateTimeFormatter .ISO0_LOCAL_DATE_TINME) ) ; 


end = start.withYear(2020); 
assertEquaLs("2020-02-02T11:30:00" ， 
end.format(DateTimeFormatter .ISO0_LOCAL_DATE_TINME) ) ; 
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QTest(expected = DateTimeException.class) 

public void withInvalidDate() throws Exception { 
LocalDateTime start = LocalDateTime.of(2017, Month.FEBRUARY, 2, 11, 30); 
start.withDayOofMonth(29); 

} 


由 于 2017 年 并 非 间 年 ， 无 法 将 日 期 设置 为 2 月 29 日 ， 第 二 个 测试 将 抛 出 DateTimeException。 
with 方法 也 可 以 传 入 TemporalAdjuster 或 TemporaLFieLd: 


LocalDateTime with(TemporalAdjuster adjuster) 
LocalDateTime with(TemporalField field, long newValue) 


传 入 TemporalField 的 with 方法 允许 字段 解析 日 期 以 使 其 有 效 。 如 例 8-9 所 示 ， 程 序 传 入 
1 月 的 最 后 一 天 ， 并 尝试 将 月 份 改 为 2 月 (“2 月 31 日 ")。 此 时 ， 根 据 Javadoc 的 描述 ， 系 
统 将 选择 前 一 个 有 效 日 期 ， 即 2 月 的 最 后 一 天 (2 月 28 日 )。 


例 8-9 月 份 调整 (无 效 ) 
QTest 
public void temporaLFieLd() throws Exception { 
LocalDateTime start = LocalDateTime.of(2017, Month.JANUARY, 31, 11, 30); 
LocalDateTime end = start.with(ChronoField.MONTH_OF_YEAR, 2); 
assertEquaLs("2017-02-28T11:30:00" ， 
end.format(DateTimeFormatter .ISO_LOCAL_DATE_TINME) ) ; 























} 


可 想 而 知 ， 日 期 和 时 间 的 处 理 涉及 一 些 相 当 复 杂 的 规则 ， 不 过 Javadoc 对 此 做 了 系统 而 详 
尽 的 描述 。 


范例 8.3 将 讨论 传 入 TemporaLAdjuster 的 with 方法 。 

器 

另 见 

有 关 TemporalAdjuster 和 TemporalQuery 的 讨论 请 参见 范例 8.3。 


8.3 ”调节 器 与 查询 


问题 
给 定 一 个 时 态 值 (temporal value)， 用 户 希 望 根据 自 定 义 逻 辑 对 其 进行 调整 ， 或 检索 给 定 
值 的 相关 信息 。 


方案 
创建 TemporalAdjuster 或 规划 TemporalQuery 接 
讨论 


TemporalAdjuster 和 TemporaLQuery 接口 中 的 类 不 仅 提 供 使 用 Date-Time API 中 各 种 类 的 有 











:| 
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趣 方式 ， 














1. TemporalAdjuster 的 应 用 


TemporalAdjuster 接口 定义 了 一 个 名 为 adjustInto 的 方法 ， 


也 提供 有 用 的 内 置 方法 以 实现 用 户 自 定 义 的 方法 。 本 范例 将 对 此 做 讨论 。 





它 传 入 Temporal 值 作为 参 











数 ， 并 返回 调整 后 的 值 。 而 TemporatAdjusters 类 包括 一 系列 用 作 静 态 方 法 的 调节 器 





(adjuster) y 


TemporaLAdjuster : 


或 许 能 为 开发 带 来 一 定 便 利 。 
以 LocalDateTime 类 为 例 ， 我 们 可 以 通 


过 时 态 对 象 (temporal object) 上 的 with 方法 使 用 


LocalDateTime with(TemporalAdjuster adjuster) 
虽然 也 可 以 使 用 TemporalAdjuster 接口 定义 的 adjustInto 方法 ,但 with 方法 应 作为 首选 
我 们 首先 讨论 TemporalAdjusters 类 ， 它 定义 了 多 种 便利 的 方法 : 


static 
static 
static 


static 
static 
static 
static 


static 
static 
static 
static 


TemporalAdjuster 
TemporalAdjuster 
TemporalAdjuster 


TemporalAdjuster 
TemporalAdjuster 
TemporalAdjuster 
TemporalAdjuster 


TemporalAdjuster 
TemporalAdjuster 
TemporalAdjuster 
TemporalAdjuster 


fiLrstDayOfNextMonth() 
fiLrstDayOfNextYear() 
fiLrstDayOfYear() 


firstIiInMonth(DayOfWeek dayOfWeek) 
LastDayOfMonth() 
LastDayOfYear() 
LastInMonth(DayOfNeek dayOfWeek) 


next(DayOfWeek dayOfWeek) 
nextOrSame(DayOfNeek dayOfWeek) 
previous(DayOfWeek dayOfWeek) 
previousOrSame(DayOfWeek dayOfWeek) 


例 8-10 的 用 例 显示 了 上 述 方法 在 实际 开发 中 的 应 用 。 
例 8-10 ”TemporalAdjusters 类 定义 的 部 分 静态 方法 


@Test 


public void adjusters() throws Exception { 


LocalDateTime start = 


LocalDateTime end = 
assertEquals("2017-03-01T11:30", end.toString()); 


end = 


start.with(Te 


LocalDateTime.of(2017, Month.FEBRUARY, 2, 11, 30); 
start.with(TemporalAdjusters.firstDayOfNextMonth()); 


mporalAdjusters.next(DayOfWeek .THURSDAY)); 


assertEquals("2017-02-09T11:30", end.toString()); 











end = start.with(TemporalAdjusters.previousOrSame(DayOfWeek .THURSDAY)); 
assertEquals("2017-02-02T11:30", end.toString()); 
} 
有 趣 之 处 在 于 编写 自 定义 调节 器 。TemporalAdjuster 是 一 个 函数 式 接口 ， 所 包含 的 单一 抽 
象 方法 为 : 


Temporal adjustInto(TemporaL temporal) 


在 讨论 时 态 调 节 器 (temporal adjuster) 时 ，Java 官方 教程 以 PaydayAdjuster 类 为 例 演 示 了 


自 





定义 调节 器 的 应 用 : 


假设 


员工 在 一 个 月 中 领取 两 次 工资 ， 且 发 薪 日 是 每 月 15 日 和 最 后 





一 天 ;如果 某 个 发 新 日 为 周 未 ， 则 提前 到 周 五 。 


为 便于 参考 ， 例 8-11 完整 复制 了 这 个 示例 的 代码 。 请 注意 ，adjustInto 方法 已 被 添加 到 实 
现 TemporalAdjuster 接口 的 PaydayAdjuster 类 中 。 


例 8-11 PaydayAdjuster 类 ( 取 自 Java 官方 教程 ) 


import java.time.DayOfWeek; 

import java.time.LocalDate; 

import java.time.temporal.Temporal; 

import java.time.temporal.TemporalAdjuster; 
import java.time.temporaL.TemporaLAdjusters; 








public class PaydayAdjuster implements TemporalAdjuster { 
public Temporal adjustInto(Temporal input) { 
LocalDate date = LocalDate.from(input); ©@ 
int day; 
if (date.getDayOfMonth() < 15) { 
day = 15; 
} elsef{ 
day = date.with(TemporalAdjusters.lastDayOfMonth()) 
.getDayOfMonth() ; 
} 
date = date.withDayOfMonth(day ) ; 
if (date.getDayOfWeek() == DayOfWeek.SATURDAY || 
date.getDayOfNeek() == DayOfWeek.SUNDAY) { 
date = date.with(TemporalAdjusters.previous(DayOfWeek .FRIDAY)); 
} 


return input.with(date); 


} 
@ fron 方法 可 以 将 任何 时 态 对 象 转换 为 LocalDate 


以 2017 年 7 月 为 例 运 行程 序 ， 其 中 7 月 15 日 是 周 六 ，7 月 31 日 是 周一 。 例 8-12 的 测试 
显示 ， 调 节 器 可 以 正确 处 理 2017 年 7 月 的 发 薪 日 。 


例 8-12 测试 调节 器 
QTest 
public void payDay() throws Exception { 
TemporalAdjuster adjuster = new PaydayAdjuster(); 
IntStream.rangeClosed(1, 14) 
.mapTo0bj(day -> LocalDate.of(2017, Month.JULY, day)) 
.forEach(date -> 
assertEquals(14, date.with(adjuster).getDayofMonth())); 





IntStream.rangeClosed(15, 31) 
.mapTo0bj(day -> LocalDate.of(2017, Month.JULY, day)) 
.forEach(date -> 
assertEquaLs(31，date.with(adjuster ).getDayOfMonth() ) ); 
} 


虽然 上 述 程序 可 以 运行 ,但 仍然 存在 改进 的 空间 。 首 先 ， 在 Java 8 之前， 如果 不 使 用 其 他 
机 制 就 无 法 创建 日 期 流 ( 例 如， 本 例 需 要 计算 天 数 )。 这 种 情况 在 Java 9 中 得 以 改变 。Java 
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9 新 增 了 一 种 返回 日 期 流 的 方法 datesUnttL， 详 细 讨 论 请 参见 范例 10.7。 


其 次 ， 为 实现 TemporalAdjuster 接口 ， 程 序 创建 了 PaydayAdjuster 类 。 由 于 TemporalAdjuster 
属于 函数 式 接口 ， 不 妨 改 为 提供 lambda 表达 式 或 方法 引用 作为 实现 。 


如 例 8-13 所 示 ， 我 们 创建 一 个 名 为 Adjusters 的 工具 类 ， 它 包括 进行 各 种 操作 所 需 的 静态 
方法 。 
例 8-13 工具 类 Adjusters 
public class Adjusters { 0 
public static Temporal adjustInto(TemporaL input) { ©@ 
LocalDate date = LocalDate.from(input); 
// 与 例 8-11 的 实现 相同 


return input.with(date); 





























} 
@ 不 实现 TemporalAdjuster 接口 
@ 静态 方法 无 须 实例 化 
写 后 的 测试 如 例 8-14 所 示 。 
例 8-14 测试 调节 器 (使 用 方法 引用 ) 


@Test 
public void payDayWithMethodRef() throws Exception { 
IntStream.rangeClosed(1, 14) 
.mapTo0bj(day -> LocalDate.of(2017, Month.JULY, day)) 
.forEach(date -> 
assertEquals(14, 
date.with(Adjusters::adjustInto).getDayOfMonth())); © 





IntStream.rangeClosed(15, 31) 
.mapTo0bj(day -> LocalDate.of(2017, Month.JULY, day)) 
.forEach(date -> 
assertEquaLs(31， 
date.with(Adjusters::adjustInto).getDayOfMonth() ) ); 
} 


@ adjustInto 的 方法 引用 
如 果 存 在 多 个 时 态 调节 器 ， 上 述 方案 可 能 更 为 通用 。 
2. TemporalQuery 的 应 用 


TemporalQuery 接口 用 作 时 态 对 象 中 query 方法 的 参数 。 以 LocalDate 类 为 例 ，query 方法 
的 签名 如 下 : 


<R> R query(TemporalQuery<R> query) 





query 方法 调用 TemporalQuery.queryFrom(TemporalAccessor) 方法 ( 传 入 this 作为 参数 )， 
并 返回 所 需 的 查询 。TemporalAccessor 接口 定义 的 所 有 方法 均 可 用 于 查询 操作 。 


Date-Time API 还 包括 一 个 名 为 TemporalQueries 的 类 ， 它 定义 了 许多 常见 查询 的 常量 : 





static TemporaLQuery<ChronoLogy> chronology() 
static TemporalQuery<LocalDate> localDate() 
static TemporalQuery<LocalTime> localTime() 
static TemporaLQuery<ZoneOffset> offset() 
static TemporalQuery<TemporalUnit> precision() 
static TemporaLQuery<ZoneId> zone() 
static TemporaLQuery<ZoneId> zoneId() 


例 8-15 的 简单 测试 展示 了 部 分 方法 的 应 用 。 
例 8-15 TemporalQueries 类 定义 的 部 分 方法 


QTest 
public void queries() throws Exception { 
assertEquals(ChronoUnit.DAYS, 
LocalDate.now().query(TemporalQueries.precision())); 
assertEquals(ChronoUnit.NANOS, 
LocalTime.now().query(TemporalQueries.precision())); 
assertEquals(ZonelId.systemDefault(), 
ZonedDateTime.now().query(TemporalQueries.zone())); 
assertEquals(ZonelId.systemDefault(), 
ZonedDateTime.now().query(TemporalQueries.zoneId())); 


} 


与 TemporalAdjuster 接口 类 似 ， 有 趣 之 处 在 于 编写 自 定义 查询 。TemporalQuery 接口 包含 
的 单一 抽象 方法 为 : 


R queryFrom(TemporaLAccessor temporal) 


如 果 给 定 参数 TemporalAccessor ， 我 们 可 以 编写 一 个 名 为 daysUntilpirateDay 的 方法 ， 以 
计算 指定 日 期 与 国际 海盗 模仿 日 (International Talk Like A Pirate Day, 9 月 19 日 ) “之 间 的 
天 数 ， 如 例 8-16 所 示 。 


例 8-16 计算 指定 日 期 与 国际 海盗 模仿 日 之 间 的 天 数 
private Long daysUntilpirateDay(TemporalAccessor temporal) { 
int day = temporal.get(ChronoField.DAY_OF_MONTH); 
int month = temporal.get(ChronoField.MONTH_OF_YEAR); 
int year = temporal.get(ChronoField.YEAR); 
LocalDate date = LocalDate.of(year, month, day); 
LocalDate tlapd = LocalDate.of(year, Month.SEPTEMBER, 19); 
if (date.isAfter(tlapd)) { 
tlapd = tlapd.plusYears(1); 














} 


return ChronoUnit.DAYS.between(date, tlapd); 


} 


由 于 daysUntilpirateDay 方法 的 签名 与 TemporalQuery 接口 包含 的 单一 抽象 方法 queryFrom 
相互 兼容 ， 可 以 通过 方法 引用 来 调用 ， 如 例 8-17 所 示 。 











注 $: 例如 ,“ 喂 ， 伙 计 ! 我 打算 把 你 加 入 我 的 LinkedIn 社交 网 络 。” 
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例 8-17 通过 方法 引用 使 用 TemporalQuery 
@Test 
public void pirateDay() throws Exception { 
IntStream.range(10, 19) 
.mapToObj(n -> LocalDate.of(2017, Month.SEPTEMBER, nN)) 
.forEach(date -> 
assertTrue(date.query(this::daysUntilpirateDay) <= 9)); 
IntStream.rangeClosed(20, 30) 
.mapToObj(n -> LocalDate.of(2017, Month.SEPTEMBER, nN)) 
.forEach(date -> { 
Long days = date.query(this::daysUntilpirateDay); 
assertTrue(days >= 354 && days < 365); 
}); 
} 


上 述 方案 也 可 用 于 创建 自 定义 查询 。 





8.4 ”将 java.util.Date 转 换 为 java.time.LocalDate 


问题 
用 户 希望 将 java.util.Date 或 java.util.Calendar 类 转换 为 java.time 包 中 相应 的 类 。 


方案 
转换 时 既 可 以 利用 Instant 类 作为 中 介 ， 也 可 以 使 用 java.sql.Date 和 java.sql.Timestamp 
类 提供 的 方法 ， 还 可 以 使 用 字符 串 或 整数 。 


讨论 
新 的 java.time 包 并 未 提供 太 多 的 内 置 方式 来 转换 java.util 包 中 用 于 处 理 标 准 日 期 和 时 
间 的 类 ， 这 点 或 许 会 让 读者 感到 讶 异 。 

为 了 将 java.util.Date 类 转换 为 java.time.LocalDate 类 ， 一 种 方案 是 调用 toInstant 方法 
来 创建 Instant， 然 后 应 用 系统 默认 时 区 (zoneId)， 并 从 生成 的 ZonedDateTinme 中 提取 出 
LocalDate， 如 例 8-18 所 示 。 

例 8-18 利用 Instant 作为 中 介 ， 将 java.util.Date 类 转换 为 java.time.LocalDate 类 


public LocalDate convertFromUtilDateUsingInstant(Date date) { 
return date.toInstant().atZzone(Zoneld.systemDefault()).toLocalDate(); 














java.util.Date 类 包含 日 期 和 时 间 信息 ， 但 并 不 提供 时 区 信息 “， 因 此 它 相 当 于 java. time. 
Instant 类 。 将 atzone 方法 应 用 到 系统 默认 时 区 将 创建 ZonedDateTime， 之 后 就 能 从 中 提取 
出 LocaLDate。 

















Java 默认 的 时 区 进行 格式 化 。 





注 6: 打印 java.util.Date 时 ， 字 符 串 





汶 
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此 外 ， 借 由 java.sql.Date 和 java.sql.Timestamp 类 定义 的 一 些 方法 ， 也 可 以 方便 地 将 
java.util.Date 类 转换 为 java.time.LocalDate 类 ， 相 关 示 例 请 参见 例 8-19 和 例 8-20。 


例 8-19 java.sql.Date 类 中 的 转换 方法 
LocaLDate toLocalDate() 
static Date valueOf(LocalDate date) 


例 8-20 ”java.sql.Timestamp 类 中 的 转换 方法 
LocalDateTime toLocalDateTime() 
static Timestamp valueOf(LocalDateTime dateTime) 


如 例 8-21 所 示 ， 我 们 创建 一 个 名 为 ConvertDate 的 类 ， 从 而 方便 地 实现 转换 。 
例 8-21 将 java.util 包 中 的 类 转换 为 java.time 包 中 相应 的 类 


package datetime; 


import java.sql.Timestamp; 
import java.time.LocalDate; 
import java.time.LocalDateTime; 
import java.util.Date; 


public class ConvertDate { 
public LocalDate convertFromSqlDatetoLD(java.sql.Date sqlDate) { 
return sqlDate.toLocalDate(); 


} 


public java.sql.Date convertToSqlDateFromLD(LocalDate localDate) { 
return java.sql.Date.valueOf(localDate); 


} 


public LocalDateTime convertFromTimestampToLDT(Timestamp timestamp) { 
return timestamp.toLocalDateTime(); 


} 


public Timestamp convertToTimestampFromLDT(LocalDateTime localDateTime) { 
return Timestamp.VvaLueOf(LocaLDateTime ) ; 
} 
} 


既然 所 需 的 方法 基于 java.sql.Date 类 ， 那 么 如 何 转换 java.util.Date (大 部 分 开发 人 员 
仍 在 使 用 ) 以 及 java.sql.Date 类 呢 ? 一 种 方案 是 利用 java.sql.Date 类 提供 的 构造 函数 ， 
根据 给 定 的 毫秒 时 间 值 创建 一 个 Date 对 象 (long 型 数据 ) 。 





纪元 时 间 与 Java 
在 基于 Unix 的 操作 系统 中 ，Unix 纪元 时 间 (Unix epoch) 也 称 为 Unix 时 间 玲 (Unix 
timestamp) 或 POSIX 时 间 (POSIX time)， 定 义 为 从 1970 年 1 月 1 日 00:00:00 UTC 
起 经 过 的 秒 数 ， 不 考虑 状 秒 。 目 前 ， 计 算 机 的 系统 时 钟 均 以 纪元 时 间 为 基础 。 
需要 注意 的 是 ， 由 于 Unix 纪元 时 间 采 用 32 位 有 符号 整数 存储 经 过 的 秒 数 ， 将 在 2038 年 
1 月 19 日 03:14:07 UTC 时 溢出 。 在 这 一 刻 之 后 ， 全 球 所 有 32 位 操作 系统 的 时 间 将 突然 
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跳 回 1901 年 12 月 13 日 。 这 就 是 所 谓 的 “2038 年 问题 ”(Year 2038 Problem) "。 尽 管 到 
那个 时 候 ， 所 有 操作 系统 应 该 都 已 升级 为 64 位 ， 但 可 能 仍 有 部 分 点 入 式 系统 尚未 更 新 。。 
Java 采用 毫秒 作为 经 过 时 间 的 单位 ， 这 或 许 会 让 情况 变 得 更 加 糟 料 。 不 过 使 用 Long 而 
非 int 存储 经 过 时 间 ， 可 以 将 溢出 问题 推 后 数 千 年 。 





java.util.Date 类 定义 了 一 个 返回 Long 型 数据 的 getTime 方法 ， 而 java.sqL.Date 类 定义 
了 一 个 传 入 该 Long 值 作为 参数 的 构造 函数 setTime”。 

因此 ， 借 由 java.sql.Date 类 ， 也 可 以 将 java.util.Date 实例 转换 为 java.time.LocalDate 
实例 ， 如 例 8-22 所 示 。 


例 8-22 将 java.util.Date 类 转换 为 java.time.LocalDate 类 


public LocalDate convertUtilDateToLocalDate(java.util.Date date) { 
return new java.sql.Date(date.getTime()).toLocalDate(); 














实际 上 ， 早 在 Java 1.1 发 布 时 ， 整 个 java.util.Date 类 就 已 被 弃 用 ， 并 推荐 采用 java. 
util.Calendar 类 作为 赫 代 。Calendar 实例 与 java.time 包 中 相应 实例 之 间 的 转换 可 以 通过 
toInstant 方法 完成 ， 并 根据 时 区 进行 调整 ， 如 例 8-23 所 示 。 


例 8-23 将 java.util.Calendar 类 转换 为 java.time. ZonedDateTime 类 


public ZonedDateTime convertFromCalendar(Calendar cal) { 
return ZonedDateTime.ofInstant(cal.toInstant(), cal.getTimeZone().toZoneld()); 





} 


上 述 方 法 使 用 ZonedDateTime 类 。LocalDateTime 类 也 定义 了 一 个 名 为 ofInstant 的 方法 ， 
不 过 由 于 某 种 原因 ， 该 方法 传人 zoneId 作为 第 二 个 参数 。 因 为 LocalDateTime 类 并 不 包含 
时 区 信息 ， 这 显得 颇 为 奇怪 。 有 鉴于 此 ， 改 用 ZonedDateTime 类 定义 的 ofInstant 方法 或 
许 更 加 直观 。 


如 果 完 全 不 必 考 虑 时 区 信息 ， 也 可 以 在 Calendar 类 上 显 式 地 使 用 各 种 getter 方法 ， 直 接 转 
换 为 相应 的 LocalDateTime， 如 例 8-24 所 示 。 


例 8-24 利用 getter 方法 将 java.util.Calendar 转换 为 java.time.LocalDateTime 


public LocalDateTime convertFromCalendarUsingGetters(Calendar cal) { 
return LocalDateTime.of(cal.get(Calendar .YEAR), 
cal.get(Calendar .MONTH), 
cal.get(Calendar .DAY_OF_MONTH), 
cal.get(Calendar .HOUR), 
cal.get(Calendar .MINUTE), 





























注 7; 参见 维基 百科 的 详细 介绍 。(32 位 有 符号 整数 的 最 大 值 为 0x7FFFFFFF， 即 2^31 - 1= 2147483647 秒 ， 
也 就 是 2038 年 1 月 19 日 03:14:07 UTC。 可 以 通过 Epoch Converter 方便 地 将 Unix 纪元 时 间 转 换 为 人 
类 可 读 的 格式 。 一 一 译 者 注 ) 

注 8: 作者 届时 想必 已 安全 退休 ， 不 过 当 2038 年 问题 发 生 时 ， 和 希望 作者 使 用 的 呼吸 机 不 会 受到 影响 。 

注 9: 事实 上 ，setTime 是 java.sqL.Date 类 中 唯一 一 个 未 被 弃 用 的 构造 国 数 ， 可 以 利用 该 方法 来 设置 现 有 
的 Date 对 象 。 
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cal.get(Calendar .SECOND) ); 
} 


另 一 种 方案 是 根据 calendar 类 生成 一 个 经 过 格式 化 的 字符 串 ， 然 后 将 其 解析 为 LocaLDateTime， 
如 例 8-25 所 示 。 


例 8-25 生成 并 解析 时 间 戳 字符 串 
public LocalDateTime convertFromUtilDateToLDUsingString(Date date) { 
DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss"); 
return LocalDateTime.parse(df.format(date), 
DateTimeFormatter .ISO_LOCAL_DATE_TINME) ; 











} 
上 述 方案 并 非特 别 理想 ， 不 过 了 解 它 并 无 坏处 。 此 外 ，Calendar 类 并 未 提供 能 直接 转换 为 
ZonedDateTime 的 方法 ， 但 GregorianCalendar 类 定义 的 tozonedDateTime 方法 可 以 实现 这 
种 转换 ， 如 例 8-26 所 示 。 


例 8-26 将 java.util.GregorianCalendar 类 转换 为 java.time.ZonedDateTime 类 


public ZonedDateTime convertFromGregorianCalendar(Calendar cal) { 
return ((GregorianCalendar) cal).toZzonedDateTime(); 























} 
上 述 程 序 可 以 执行 ， 不 过 前 提 是 采用 公历 (Gregorian calendar)。 由 于 GregorianCalendar 
类 是 calendar 类 的 唯一 实现 ， 这 种 前 提 应 该 成 立 ， 但 无 法 百分之百 确定 。 
最 后 ，Java 9 为 LocalDate 类 引入 了 ofInstant 方法 ， 使 得 转换 操作 更 为 简单 ， 如 例 8-27 
所 示 。 
例 8-27 将 java.util.Date 类 转换 为 java.time.LocalDate 类 ( 仅 针 对 Java 9) 


public LocalDate convertFromUtilDateJava9(Date date) { 
return LocalDate.ofInstant(date.toInstant(), ZonelId.systemDefault()); 


























} 
这 种 方案 更 直接 ， 但 仅 能 在 Java 9 中 使 用 


8.5 解析 与 格式 化 


问题 

用 户 希 望 解析 或 格式 化 Date-Time API 中 的 类 。 

方案 

DateTimeFormatter 类 用 于 创建 日 期 /时 间 格 式 ， 可 以 在 解析 和 格式 化 中 使 用 
讨论 

DateTimeFormatter 类 提供 大 量 预定 义 格式 化 器 (predefined formatter)， 包 括 常 量 (如 IS0_ 
LOCAL_DATE) 、 模 式 字 母 (如 uuuu-MMM-dd) 以 及 本 地 化 样式 (如 ofLocalizedDate(dateStyle))。 





o 











o 
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好 在 解析 和 格式 化 的 过 程 并 不 复杂 。 在 Date-Time API 中 ， 所 有 主要 的 类 均 提 供 parse 和 
format 方法 。 以 LocalDate 类 为 例 ， 其 parse 和 format 方法 的 签名 如 例 8-28 所 示 。 


例 8-28 LocalDate 类 定义 的 parse 和 format 方法 
static LocalDate parse(CharSequence text) © 
static LocalDate parse(CharSequence text, DateTimeFormatter formatter) 
String format(DateTimeFormatter formatter) 








@ 使 用 ISO_LOCAL_DATE 
解析 和 格式 化 的 应 用 如 例 8-29 所 示 。 
例 8-29 对 LocalDateTime 解析 和 格式 化 


LocalDateTime now = LocalDateTime.now(); 
String text = now.format(DateTimeFormatter.ISO_DATE_TIME); © 
LocalDateTime dateTime = LocalDateTime.parse(text); @ 


@ 将 LocalDateTime 格式 化 为 字符 
@ 将 字符 串 解析 为 LocaLDateTime 
因此 ， 我 们 可 以 调整 日 期 /时 间 格 式 、 区 域 设置 等 各 种 参数 。 部 分 应 用 如 例 8-30 所 示 。 
例 8-30 对 日 期 进行 格式 化 


LocalDate date = LocalDate.of(2017, Month.MARCH, 13); 





Hd 








System.out.printLn("FULL : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.FULL))); 
System.out.printLn("Long : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.LONG))); 
System.out.println("Medium : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.MEDIUM))); 
System.out.println("Short : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.SHORT))); 
System.out.println("France : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.FULL) 
.withLocale(Locale.FRANCE))); 
System.out.println("India : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.FULL) 
.withLocale(new Locale("hin", "IN")))); 
System.out.println("Brazil : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.FULL) 
.withLocale(new Locale("pt", "BR")))); 
System.out.println("Japan : "+ 
date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.FULL) 
.withLocale(Locale.JAPAN))); 


Locale loc = new Locale.Builder() 
.setLanguage("sr") 
.setScript("Latn") 
.SetRegion("RS") 
.build(); 

System.out.println("Serbian: + 

date.format(DateTimeFormatter .ofLocalizedDate(FormatStyle.FULL) 

.withLocale(loc))); 





156 | 第 8 章 


执行 上 述 程序 ， 输 出 类 似 于 : ” 


FULL : Monday, March 13, 2017 
Long : March 13, 2017 

Medium : Mar 13, 2017 

Short : 3/13/17 





France : lundi 13 mars 2017 

India : Monday, March 13, 2017 

Brazil : Segunda-feira, 13 de Marco de 2017 
Japan : 2017 年 3 月 13 日 

Serbian: ponedeljak, 13. mart 2017 


由 于 parse 和 format 方法 分 别 抛 出 DateTimeParseException 和 DateTimeException， 用 户 
可 能 希望 在 自己 的 代码 中 捕获 它们 。 


我 们 也 可 以 通过 DateTimeFormatter 类 提供 的 ofPattern 方 法 创建 自 定义 格式 化 器 
Javadoc 详细 描述 了 所 有 可 以 使 用 的 合法 值 。ofPattern 方法 的 应 用 如 例 8-31 所 示 。 


例 8-31 自 定义 格式 化 模式 
ZonedDateTime moonLanding = ZonedDateTime.of( 
LocalDate.of(1969, Month.JULY, 20), 
LocalTime.of(20, 18), 
ZoneId.of("UTC") 





); 
System.out.println(moonLanding.format(DateTimeFormatter .ISO_ZONED_DATE_TINME) ) ; 


DateTimeFormatter formatter = 
DateTimeFormatter .ofPpattern("uuuu/MMMM/dd hh:mm:ss a zzz GG"); 
System.out.println(moonLanding.format(formatter)); 


formatter = DateTimeFormatter .ofPattern("UUUU/MMMM/dd hh:mm:ss a VV xxxxx"); 
System.out.println(moonLanding.format(formatter)); 


输出 如 下 : 


1969-07-20T20:18:00Z[UTC] 
1969/JuLy/20 08:18:00 PM UTC AD 
1969/JuLy/20 08:18:00 PM UTC +00:00 


有 关 DateTimeFormatter 类 的 用 途 以 及 各 种 模式 字母 的 含义 ， 见 Javadoc。 不 过 读者 无 
须 担 心 ， 格 式 化 的 过 程 并 不 复杂 。 


接 下 来 ， 我 们 通过 夏 时 制 (daylight savings time) 问题 来 展示 本 地 化 日 期 /时 间 格 式 化 器 的 
应 用 。 北 美 东 部 时 区 (EST) 从 2018 年 3 月 11 日 凌晨 2 时 起 实行 夏 时 制 ， 将 时 钟 调 快 一 
小 时 。 那 么 在 3 月 11 日 凌晨 2 时 30 分 时 ， 某 个 地 区 的 日 期 和 时 间 是 多 少 呢 ?相关 示例 如 
例 8-32 所 示 。 




















注 10: 有 传言 说 ， 作 者 有 意 选 择 稀有 语种 和 输出 格式 ， 只 是 为 了 测试 OReilly Media 能 否 正确 打印 出 相应 的 
结果 。 不 过 至 少 就 读者 所 知 ， 这 并 非 事 实 。 
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例 8-32 将 时 钟 调 快 一 小 时 
ZonedDateTime zdt = ZonedDateTime.of(2018, 3, 11, 2, 30, 0, 0, 
ZoneId.of("America/New_York'" )); 
System.out.printLn( 
zdt.format(DateTimeFormatter .ofLocalizedDateTime(FormatStyle.FULL))); 


在 本 例 中 ，ZzonedDateTime.of 方法 传 和 年、 月、 日 、 小 时 、 分 、 秒 、 纳 秒 以 及 时 区 作为 参 
数 。 除 时 区 (zoneId) 外 ， 其 他 字段 均 为 int 类 型 ， 即 无 法 使 用 Month 枚 举 。 


输出 如 下 : 


Sunday, March 11, 2018 3:30:00 AM EDT 


可 以 看 到 ， 程 序 将 时 间 从 凌晨 2 时 30 分 调整 为 凌晨 3 时 30 分 。 
8.6 查找 具有 非 整 数 小 时 偏 移 量 的 时 区 


问题 
用 户 希望 查找 所 有 具有 非 整 数 小 时 偏 移 量 (non-integral hour offset) 的 时 区 。 


方案 
获取 每 个 时 区 的 时 区 偏 移 量 ， 并 计算 总 秒 数 除 以 3600 之 后 的 剩余 时 间 。 


讨论 

大 部 分 时 区 的 UTC 偏 移 量 为 小 时 的 整数 。 例 如 ， 通常 所 说 的 北美 东部 时 区 (EST) 为 
UTC-05:00， 而 欧洲 中 部 时 间 (CET) 为 UTC+01:009。 不 过 也 存在 UTC 偏 移 量 为 半 小 时 甚至 
45 分 钟 的 时 区 ， 如 印度 标准 时 间 (IST) 为 UTCcrt95:30， 而 查 塔 姆 标准 时 间 (CHAST) 为 
UTC+12:45。 本 范例 将 讨论 利用 java.time 包 查 找 所 有 具有 韭 整数 小 时 偏 移 量 的 时 区 。 


如 例 8-33 所 示 ， 我 们 通过 zone0ffset 类 查找 每 个 时 区 ID 相对 于 UTC 的 偏 移 量 ， 并 将 寺 
总 秒 数 与 3600 秒 (1 小 时 ) 进行 比较 。 


例 8-33 查找 每 个 时 区 ID 的 偏 移 量 (以 秒 为 单位 ) 
public class FunnyOffsets { 
public static void main(String[] args) { 
Instant instant = Instant.now(); 
ZonedDateTime current = instant.atZone(ZoneId.systemDefauLt() ); 
System.out.printf("Current time is %s%n%n", current); 




















-| 


System.out.printf("%10s %20s %13s%n", "Offset", "ZoneId", "Time"); 
ZonelId.getAvailableZonelIds().stream() 
.map(ZoneId::of) ©@ 
.fiLLter(zoneId -> { 
ZoneOffset offset = instant.atZone(zoneId).getOoffset(); @ 
return offset.getTotalSeconds() % (60 * 60) != 0; 日 
}) 
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.Sorted(comparingInt(zoneld -> 
tinstant.atZone(zoneId).getOffset() .getTotaLSeconds())) 
.forEach(zoneId -> { 
ZonedDateTime zdt = current.withZoneSameInstant(zoneld); 
System.out.printf("%10s %25s %10s%n", 
zdt.getOffset(), zoneld, 
zdt.format(DateTimeFormatter .ofLocalizedTime( 
FormatStyle.SHORT))); 
]); 


} 
@ 将 地 区 ID (字符 串 ) 映射 到 时 区 ID 
@ 计算 偏 移 量 
@ 仅 返 回 偏 移 量 无 法 被 3600 整除 的 时 区 ID 


ZoneId.getAvailableZzoneIds 静态 方法 返回 Set<String>， 表 示 所 有 可 用 的 时 区 ID; 
ZoneId.of 方法 将 生成 的 字符 串 流 转换 为 zoneId 实例 流 。 


在 本 例 中 ， 算 选 器 中 的 lambda 表达 式 首先 将 atzone 方法 应 用 到 Instant 以 创建 ZonedDateTime， 
然后 应 用 getoffset 方法 。 最 后 ， 利 用 Zoneoffset 类 定义 的 getTotalSeconds 方法 获取 时 区 
偏 移 量 ee 根据 Javadoc getTotalSeconds 方法 是 “访问 偏 移 量 的 主要 
方式 ， 它 返回 小 时 、 分 、 秒 字段 的 总 和 “以 秒 为 单位 )， 作 为 一 个 偏 移 量 添加 到 给 定 的 时 
间 ”。 i 3600 (60 2 * 60 min/hour) 整除 时 ， 筛 选 器 中 的 Predicate 
才 返 回 true。 


在 打印 结果 前 ， 程 序 对 生成 的 zoneId 实例 排序 。sorted 方法 传 入 Comparator 作为 参数 。 
本 例 使 用 Comparator 接口 定义 的 静态 方法 comparingInt， 它 生成 一 个 根据 给 定 整 数 键 排 
序 的 Comparator。 程 序 同样 采用 getTotalseconds 方法 获取 时 区 偏 移 量 (以 秒 为 单位 )， 
ZoneId 实例 根据 偏 移 量 进行 排序 。 


接 下 来 ， 针 对 每 个 zoneId， 程 序 使 用 withzoneSameInstant 方法 计算 默认 时 区 中 
ZonedDateTime， 以 打印 结果 。 打 印 的 字符 串 将 显示 偏 移 量 、 时 区 ID 以 及 相应 时 区 中 经 
格式 化 的 本 地 时 间 。 


程序 的 执行 结果 如 例 8-34 所 示 。 
例 8-34 具有 非 整数 小 时 偏 移 量 的 时 区 


Current time is 2016-08-08T23:12:44.264-04:00[America/New_York] 



























































offset ZoneId Time 

-09:30 Pacific/Marquesas 5:42 PM 
-04:30 America/Caracas 10:42 PM 
-02:30 America/St_Johns 12:42 AM 
-02:30 Canada/Newfoundland 12:42 AM 
+04:30 Iran 7:42 AM 
+04:30 Asia/Tehran 7:42 AM 
+04:30 Asia/Kabul 7:42 AM 
+05:30 Asia/Kolkata 8:42 AM 
+05:30 Asia/CoLombo 8:42 AM 
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+05:30 Asia/Calcutta 8:42 AM 
+05:45 Asia/Kathmandu 8:57 AM 
+05:45 Asia/Katmandu 8:57 AM 
+06:30 Asia/Rangoon 9:42 AM 
+06:30 Indian/Cocos 9:42 AM 
+08:45 Australia/Eucla 11:57 AM 
+09:30 Australia/North 12:42 PM 
+09:30 Australia/Yancowinna 12:42 PM 
+09:30 Australia/Adelaide 12:42 PM 
+09:30 Australia/Broken Hill 12:42 PM 
+09:30 Australia/South 12:42 PM 
+09:30 Australia/Darwin 12:42 PM 
+10:30 Australia/Lord_Howe 1:42 PM 
+10:30 Australia/LHI 1:42 PM 
+11:30 Pacific/Norfolk 2:42 PM 
+12:45 NZ-CHAT 3:57 PM 
+12:45 Pacific/Chatham 3:57 PM 





可 以 看 到 ， 将 java.time 包 中 的 多 个 类 结合 在 一 起 使 用 ， 就 能 解决 复杂 而 有 趣 的 问题 
8.7 根据 UTC 偏 移 量 查找 地 区 名 

问题 

给 定 某 个 UTC 偏 移 量 时 ， 用 户 希 望 查找 ISO 8601 标准 定义 的 地 区 名 。 


方案 
根据 给 定 的 偏 移 量 ， 筛 选 所 有 可 用 的 时 区 ID。 





讨论 

尽管 “东部 夏令 时 ”(Eastern Daylight Time) 和 “印度 标准 时 间 ” (Indian Standard Time) 
这 样 的 时 区 名 已 广为人知 ， 但 它们 并 非 ISO 官方 名 称 ， 其 缩写 “EDT” 和 “IST” 在 某 些 
情况 下 甚至 不 是 唯一 的 。ISO 8601 标准 采用 以 下 两 种 方式 定义 时 区 ID。 


。 根据 地 区 名 (region name)， 如 “America/Chicago”。 
。 根据 以 小 时 和 分 为 单位 的 UTC 偏 移 量 (UTC offset)， 如 “+05:30”。 


那么 ， 如 何 根据 给 定 的 UTC 偏 移 量 获取 相应 的 地 区 名 呢 ? 对 于 任意 给 定 的 时 间 ， 虽 然 许 
多 地 区 的 UTC 偏 移 量 相同 ， 但 在 给 定 偏 移 量 的 情况 下 ， 不 难 计算 出 相应 的 地 区 名 列表 。 


ZoneOffset 类 用 于 获取 某 个 时 区 相对 于 格林 尼 治 /UTC 时 间 的 偏 移 量 。 如 有 果 给 定 偏 移 量 ， 
也 可 以 使 用 它 筛选 完整 的 地 区 名 列表 ， 如 例 8-35 所 示 。 


例 8-35 根据 给 定 的 偏 移 量 ， 获 取 相 应 的 地 区 名 


public static List<String> getRegionNamesForOffset(ZoneOffset offset) { 
LocalDateTime now = LocalDateTime.now(); 
return ZoneId.getAvaiLabLeZzoneIds().stream() 






























































.map(ZoneId: :of) 
.filter(zoneld -> now.atZzone(zoneId).getoffset().equaLs(offset)) 
.map(ZoneId: :toString) 
.Sorted() 
.collect(Collectors. toList()); 
} 


在 本 例 中 ，ZzoneId.getAvailableZzoneIds 方法 返回 一 个 由 字符 串 构 成 的 List， 每 个 字符 串 
通过 zoneId.of 方法 映射 到 相应 的 ZoneId。 利 用 LocalDateTime 类 定义 的 atzone 方法 确定 
ZoneId 对 应 的 ZonedDateTime 之 后 ， 就 能 得 到 所 有 zoneId 的 Zoneoffset， 并 筛 掉 其 中 不 匹配 
的 Zoneoffset。 接 下 来 ,程序 将 结果 映射 到 字符 串 、 对 字符 串 排序 并 将 它们 收集 到 List 中 。 


反 过 来 ， 如 何 获 取 zone0ffset 呢 ? 一 种 方案 是 利用 给 定 的 zoneId， 如 例 8-36 所 示 。 
例 8-36 根据 给 定 的 时 区 ， 获取 相应 的 偏 移 量 


public static List<String> getRegionNamesForZoneId(ZoneId zoneId) { 
LocalDateTime now = LocalDateTime.now(); 
ZonedDateTime zdt = now.atZzone(zoneld); 
ZoneOffset offset = zdt.getOffset(); 





























return getRegionNamesForOffset(offset); 


} 
上 述 代码 适用 于 任何 给 定 的 zoneId。 
例 8-37 显示 了 如 何 获取 与 用 户 当前 位 置 对 应 的 地 区 名 列表 。 
例 8-37 获取 当前 的 地 区 名 


QTest 

public void getRegionNamesForSystemDefault() throws Exception { 
ZonedDateTime now = ZonedDateTime.now(); 
ZoneId zoneId = now.getZzone(); 
List<String> names = getRegionNamesForZoneId(zoneId); 














assertTrue(names.contains(zoneld.getId())); 


} 
如 果 希 望 通过 GMT 偏 移 量 (以 小 时 和 分 为 单位 ) 获取 地 区 名 ， 也 可 以 使 用 zoneoffset 类 
定义 的 ofHoursMinutes 方法 ， 如 例 8-38 所 示 。 
例 8-38 根据 给 定 的 偏 移 量 (以 小 时 和 分 为 单位 )， 获 取 地 区 名 
public static List<String> getRegionNamesForOffset(int hours, int minutes) { 


ZoneOffset offset = ZoneOffset.ofHoursMinutes(hours, minutes); 
return getRegionNamesForOffset(offset); 




















} 


如 例 8-39 所 示 ， 我 们 编写 儿 个 测试 ， 验 证 在 给 定 偏 移 量 的 情况 下 ， 能 否 成 功 获取 相应 的 地 
区 名 。 


例 8-39 根据 给 定 的 偏 移 量 ,测试 能 否 成 功 获 取 地 区 名 
QTest 
public void getRegionNamesForGMT() throws Exception { 
List<String> names = getRegionNamesForOffset(0, 0); 











javatime 包 | 161 


assertTrue(names.contains("GMT")); 
assertTrue(names.contains("Etc/GMT")); 
assertTrue(names.contains("Etc/UTC")); 
assertTrue(names.contains("UTC")); 
assertTrue(names.contains("Etc/Zulu")); 


} 


@Test 
public void getRegionNamesForNepal() throws Exception { 
List<String> names = getRegionNamesForOffset(5, 45); 


assertTrue(names.contains("Asia/Kathmandu")); 
assertTrue(names.contains("Asia/Katmandu")); 


} 


@Test 
public void getRegionNamesForChicago() throws Exception { 
ZoneId chicago = ZoneId.of("America/Chicago" ); 
List<String> names = RegionIdsByOffset.getRegionNamesForZoneId(chicago); 


assertTrue(names.contains("America/Chicago")); 
assertTrue(names.contains("US/Central")); 
assertTrue(names.contains("Canada/Central")); 
assertTrue(names.contains("Etc/GMT+5") || names.contains("Etc/GMT+6")); 


} 





有 关 时 区 列表 的 详细 信息 ， 请 参见 维基 百科 。 
8.8 获取 事件 之 间 的 时 间 


问题 
用 户 和 希望 获取 两 个 事件 之 间 的 时 间 。 
方案 
如 果 需 要 将 时 间 转 换 为 人 类 可 读 的 格式 ， 使 用 时 态 类 (temporal class) 定义 的 between 或 


until 方法， 或 Period 类 定义 的 between 方法 以 生成 Period 对 象 ， 如果 不 需要 转换 时 间 格 
式 ， 则 使 用 以 秒 和 纳 秒 为 单位 对 时 间 量 进行 建 模 的 Duration 类。 


讨论 


在 java.time.temporal 包 中 ，TemporatLUnit 接口 由 定义 在 同一 个 包 中 的 ChronoUnit 枚 举 实 


现 。TemporalUnit 接口 定义 了 一 个 名 为 between 的 方法 ， 


返回 

















回 二 者 之 间 的 时 间 量 (Long 型 数据 ) : 


Long between(Temporal temporaL1IncLusive， 
Temporal temporal2Exclusive) 





它 传 入 两 个 TemporalUnit 实例 六 


让 











请 注意 ， 起 始 时 间 和 终止 时 间 的 类 型 必须 相互 兼容 。 在 计算 时 间 量 之 前 ， 实 现 将 第 二 个 类 
型 转换 为 第 一 个 类 型 的 实例 。 如 果 终 止 时 间 早 于 起 始 时 间 ， 则 结果 为 负 。 

between 方法 的 返回 值 是 两 个 参数 之 间 的 完整 “单位 ” 数 , 这 为 使 用 ChronouUnit 定义 的 枚 
举 常量 提供 了 便利 。 

例如 ， 假 设 我 们 希望 获取 当天 与 今后 革 个 特定 日 期 之 间 的 天 数 。 由 于 需要 处 理 的 是 天 数 ， 
使 用 ChronouUnit 定义 的 枚 举 常 量 ChronoUnit.DAYS， 如 例 8-40 所 示 。 

例 8-40 计算 当天 到 2020 年 美国 选举 日 (11 月 3 日 ) 之 间 的 天 数 


LocalDate electionDay = LocalDate.of(2020, Month.NOVEMBER, 3); 
LocalDate today = LocalDate.now(); 



































System.out.printf("%d day(s) to go...%n", 
ChronoUnit.DAYS.between(today, electionDay)); 


程序 在 ChronoUnit.DAYS 上 调用 between 方法 ， 并 返回 两 个 日 期 之 间 的 天 数 。ChronoUnit 定 
义 的 其 他 枚 举 常量 包括 HOURS、WEEKS、MONTHS、YEARS、DECADES、CENTURIES 等 。” 





1. java.time.Period 类 
我 们 可 以 利用 Period 类 将 时 间 分 解 为 符合 人 类 阅读 习惯 的 年 、 月 、 日 格式 。 不 少 基本 类 的 
until 方法 都 返回 Period: 


// java.time.LocalDate 类 
Period until(ChronoLocalDate endDateExclusive) 


重 写 例 8-40， 结 果 如 例 8-41 所 示 。 
例 8-41 通过 Period 类 获取 年 、 月 .日 


LocalDate electionDay = LocalDate.of(2020, Month.NOVEMBER, 3); 
LocalDate today = LocalDate.now(); 








Period until = today.until(electionDay); © 


years = until.getYears(); 

months = until.getMonths(); 

days = until.getDays(); 

System.out.printf("%d year(s), %d month(s), and %d day(s)%n", 
years, months, days); 


@ 相当 于 Period.between(today, electionDay) 


从 本 例 的 注释 可 以 看 到 ，Period 类 同样 定义 了 一 个 名 为 between 的 静态 方法 ， 其 用 法 与 
until 方法 并 无 区 别 。 选 择 哪 种 样式 均 可 ， 但 应 以 有 助 于 提高 代码 可 读 性 为 原则 。 


简 而 言 之 ， 如 果 需 要 将 时 间 转 换 为 人 类 可 读 的 格式 (如 年 、 月 、 日 )， 应 使 用 Period 类 。 











注 11:; 返 回 值 为 整数 (whole number)。 例 如 ，15:00 和 16:59 之 间 的 小 时 数 为 1 小时， 即便 它 和 2 小 时 只 差 
1 分钟。 一 一 译 者 注 
注 12:; 无 论 相信 与 否 ，ChronoUnit 中 还 包括 一 个 名 为 FOREVER 的 枚 举 常 量 。 如 果 读 者 在 开发 中 确实 用 到 了 这 
个 常量 ， 请 告诉 作者 ， 作 者 很 想 看 看 它 的 实际 应 用 。( 根 据 Javadoc 的 描述 ，FOREVER 是 一 个 表示 永恒 
概念 的 人 造 单位 ， 通 常 与 TemporalField 一 起 使 用 ， 代 表 年 份 和 时 代 这 样 的 无 界 字段 。 一 一 译 者 注 ) 
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2. java.time.Duration 类 

Duration 类 表示 以 秒 和 纳 秒 为 单位 的 时 间 量 ， 通 常 与 Instant 一 起 使 用 ,结果 可 以 转换 为 
许多 其 他 类 型 。Duration 类 存储 一 个 表示 秒 的 Long 型 数据 以 及 一 个 表示 纳 秒 的 int 型 数 
据 。 如 果 终 点 早 于 起 点 ， 则 结果 为 负 。 

例 8-42 显示 了 如 何 利用 Duration 实现 简单 的 计时 。 


例 8-42 对 某 个 方法 进行 计时 
public static double getTiming(Instant start, Instant end) { 
return Duration.between(start, end).toMillis() / 1000.0; 
} 














Instant start = Instant.now(); 

// 调用 需要 计时 的 方法 

Instant end = Instant.now(); 
System.out.println(getTiming(start, end) + " seconds"); 


这 种 对 方法 计时 的 手段 并 不 高 明 ， 但 胜 在 简单 易 行 。 


Duration 类 定义 了 toDays、toHours、toMillis、toMinutes、toNanos 等 多 种 转换 方法 ， 
就 是 本 例 中 getTiming 方法 使 用 toMtLLis 并 除 以 1000 的 原因 。 


[ey 
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并 行 与 并 发 





这 一 章 将 讨论 Java 8 中 的 并 行 (parallelization) 和 并 发 (concurrency) 。 某 些 概念 可 以 追 训 
到 早期 版 本 (特别 是 Java 5 引入 的 java.util.concurrent 包 )， 不 过 Java 8 对 并 行 和 并 发 
进行 了 强化 ， 使 得 开发 人 员 可 以 在 更 高 的 抽象 层次 上 操作 。 

在 讨论 并 行 和 并 发 时 ， 有 人 会 非常 在 意 这 两 个 术语 之 间 的 区 别 。 我 们 对 二 者 做 一 简单 定义 。 
。 并 发 : 多 个 任务 可 以 在 重合 的 时 间 段 内 运行 。 

。 并 行 : 多 个 任务 可 以 同时 运行 。 

并 发 设计 指 将 一 个 任务 分 解 为 多 个 能 同时 运行 的 独立 操作 一 一 即便 目前 尚未 这 样 处 理 。 换 
言 之 ， 并 发 应 用 程序 由 若干 独立 执行 的 进程 组 成 。 如 果 存 在 多 个 处 理 单元 ， 就 可 以 并 行 地 
实现 这 些 并 发 任务 ， 但 性 能 是 否 会 因此 而 提升 将 视 情 况 而 定 '。 
那么 ， 并 行为 什么 在 某 些 情况 下 无 助 于 性 能 提升 呢 ? 原因 是 多 方面 的 。 对 Java 而 言 ， 并 
行 在 默认 情况 下 将 任务 分 解 成 多 个 子 任 务 ， 每 个 子 任务 被 分 配给 通用 fork/join 线程 池 
(common fork/join pool) 并 执行 ， 最 后 将 所 有 结果 合并 在 一 起 。 但 是 ， 所 有 操作 都 会 引入 
开销 ， 而 很 多 预期 的 性 能 提升 取决 于 问题 映射 到 算法 的 程度 。 对 于 是 否 使 用 并 行 ， 不 妨 参 
考 本 章 范 例 给 出 的 指导 方针 。 

Java 8 使 并 行 变 得 简单 易 行 。Clojure 语言 之 父 Rich Hickey 在 Strange Loop 2011 上 以 
“Simple Made Easy” 为 题 ， 对 此 做 了 精彩 的 阐述 。Hickey 表示 ， 一 个 基本 概念 是 简单 
(simple) 和 容易 (easy) 这 两 个 词 具 有 不 同 的 含义 。 简 而 言 之 ， 简 单 的 事物 在 概念 上 并 无 
歧义 ， 而 容易 的 事物 在 看 似 容易 的 背后 或 许 隐藏 了 巨大 的 复杂 性 。 例 如 ， 有 些 排序 算法 很 






























































注 1: Go 语言 之 父 Rob Pike 在 题 为 “Concurrency Is Not Parallelism” 的 演讲 中 ， 对 这 两 个 概念 做 了 精彩 且 
扼要 的 解释 。 感 兴趣 的 读者 可 以 观看 上 传 到 YouTube 的 演讲 视频 。 
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简单 ， 有 些 则 不 然 ， 但 调用 Stream.sorted 方法 总 是 很 容易 “。 


并 行 和 并 发 处 理 涉 及 多 方面 的 内 容 ， 是 一 个 邻 人 颇 感 头疼 的 话题 。Java 在 面世 之 初 就 引 
0 
synchronized 关键 字 。 但 使 用 这 样 的 原 语 (primitives) 实现 并 发 难 如 登 天 ， 因 此 Java 5 引入 
了 java.util.concurrent 包 。 借 由 ExecutorService、BlockingQueue 接口 以 及 ReentrantLock 
类 ， 开 发 人 员 得 以 在 更 高 的 抽象 层次 上 处 理 并 发 。 尽 管 如 此 ， 并 发 管理 仍然 不 是 一 项 轻松 
的 工作 ， 特 别 是 遇 到 堪 称 梦 麻 的 “共享 可 变 状 态 ”(shared mutable state) 时 。 


而 在 Java 8 中 ， 请 求 并 行 流 不 再 是 难事 ， 因 为 只 需 进行 一 次 方法 调用 。 问 题 在 于 ， 性 能 提 
升 并 不 简单 。 之 前 存在 的 所 有 问题 其 实 仍然 存在 ， 它 们 只 是 被 隐藏 在 表面 之 下 而 已 。 


并 发 和 并 行 的 讨论 分 散 于 全 书 , 这 一 章 的 范例 无 法 涵盖 全 部 内 容 。” 本 章 旨 在 介绍 各 种 可 用 
的 机 制 及 其 用 法 。 掌 握 这 些 知 识 和 概念 后 ， 读 者 可 以 将 它们 应 用 到 开发 中 ， 并 根据 实际 情 
况 决定 是 否 使 用 并 发 和 并 行 


9.1 将 顺序 流转 换 为 并 行 流 
问题 


无 论 默认 情况 如 何 ， 用 户 希 望 创建 顺序 流 (sequential stream) 或 并 行 流 (parallel stream ) 。 
方案 

既 可 以 使 用 CoLLection 接口 定义 的 stream 或 paraLLeLStream 方 法 ， 也 可 以 使 用 
BaseStrean 接口 定义 的 sequential 或 parallel 方法 。 




















































































































讨论 
默认 情况 下 ，Java 创建 的 流 都 是 顺序 流 。 在 BaseStreanm 接口 〈Streanm 的 父 接口 ) 中 ， 可 以 
通过 isParallel 方法 判断 流 是 否 采用 并 行 方式 执行 。 
从 例 9-1 可 以 看 到 ， 所 有 采用 标准 机 制 创建 的 流 都 是 顺序 流 。 
例 9-1 创建 顺序 六 (JUnit 测试 的 一 部 分 ) 
@Test 


public void sequentialStreamOf() throws Exception { 
assertFalse(Stream.of(3, 1, 4, 1, 5, 9).isPparallel()); 

















} 








注 2: 在 《星际 迷航 :下 一 代 》 中 ,饰演 皮卡 德 舰 长 (Captain Picard) 的 帕特里克 。 斯 图 尔 特 (Patrick Stewart) 

为 “简单 ”与 “容易 ”做 了 另 一 个 很 好 的 注脚 : 编剧 试 图 向 斯 图 尔 特 描述 进入 行星 轨道 所 需 的 全 部 详 

细 步 又， 斯 图 尔 特 答 道 :“ 何 必 这 么 繁琐 ? 告诉 我 “标准 轨道 ， 少 尉 ”就 够 了 。 

注 3: 感 兴趣 的 读者 可 以 阅读 Brian Goetz 撰写 的 Java Concurrency in Practice 一 书 (由 Addison-Wesley 
Professional 于 2006 年 5 月 出 版 )， 以 及 Venkat Subramaniam 撰写 的 Programming Concurrency on the 
JVM 一 书 (由 Pragmatic Bookshelf 于 2011 年 9 月 出 版 )。 
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QTest 
public void sequentiaLIterateStream() throws Exception { 
assertFalse(Stream.iterate(1, n -> n + 1).isparallel()); 


} 


QTest 
public void sequentialGenerateStream() throws Exception { 
assertFalse(Stream.generate(Math: :random).isparallel()); 


} 


QTest 

public void sequentiaLCoLLectionStream() throws Exception { 
List<Integer> numbers = Arrays.asList(3, 1, 4, 1, 5, 9); 
assertFalse(numbers.stream().isparallel()); 


} 
如 果 数 据 源 为 集合 ， 可 以 通过 parallelStrean 方法 返回 一 个 可 能 的 并 行 流 ， 如 例 9-2 所 示 。 
例 9-2 paratllelstrean 方法 的 应 用 


QTest 

public void parallelStreamMethodOnCollection() throws Exception { 
List<Integer> numbers = Arrays.asList(3, 1, 4, 1, 5, 9); 
assertTrue(numbers.parallelStream().isparallel()); 




















} 


之 所 以 强调 “可 能 的 "， 是 因为 parallelstrean 方法 在 某 些 情况 下 也 会 返回 顺序 
认 返 回 的 是 并 行 流 。Javadoc 指出 ， 仅 当 创 建 自 定义 spliterator 时 才 会 返回 顺序 ; 
这 种 情况 相当 罕见 。” 

如 例 9-3 所 示 ， 也 可 以 通过 在 现 有 流 上 使 用 parallel 方法 来 创建 并 行 流 。 

例 9-3 在 流 上 使 用 parallel 方 法 


QTest 
public void paraLLeLMethodonStream() throws Exception { 
assertTrue(Stream.of(3, 1, 4, 1, 5, 9) 
.parallel() 
.isparallel()); 




















} 
与 parallel 方法 相对 的 是 sequential 方法 ， 它 将 返回 顺序 流 ， 如 例 9-4 所 示 。 
例 9-4 将 并 行 流 转换 为 顺序 流 


QTest 
public void parallelStreamThenSequential() throws Exception { 
List<Integer> numbers = Arrays.asList(3, 1, 4, 1, 5, 9); 
assertFalse(numbers.parallelStream() 
.sequential() 
.isparallel()); 





注 4: 址 庸 置疑 ， 这 是 一 个 有 趣 的 话题 。 不 过 受 篇 幅 所 限 ， 本 书 不 对 此 做 讨论 。 
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不 过 转换 时 需 谨 慎 行 事 ， 否 则 可 能 落 入 陷阱 。 假 设 我 们 计划 创建 一 个 流水 线 (pipeline)， 
其 中 一 部 分 处 理 可 以 并 行 地 完成 ， 而 其 他 处 理 仍然 按 顺 序 执行 。 那 么 ， 我 们 很 容易 写 出 如 
例 9-5 所 示 的 代码 。 


例 9-5 并 行 流 到 顺序 流 的 切换 (与 预期 结果 不 同 ) 
List<Integer> numbers = Arrays.asList(3, 1, 4, 1, 5, 9); 
List<Integer> nums = numbers.parallelStream() ©@ 

.map(n -> nx 2) 

.peek(n -> System.out.printf("%s processing %d%n", 
Thread.currentThread().getName(), n)) 

.Sequential() 

.Sorted() 

.Collect(Collectors. toList()); 


@ 请 求 并 行 流 

@ 先 切换 为 顺序 流 ， 再 排序 

上 述 代码 的 含义 不 难 理解 : 先 将 所 有 数字 倍增 ， 再 排序 。 由 于 倍增 函数 是 无 状态 (stateless) 
且 关 联 的 (associative) ， 采 用 并 行 操 作 可 谓 顺 理 成 章 。 然 而 ， 排 序 本 质 上 属于 顺序 操作 >。 


在 本 例 中 ，peek 方法 用 于 显示 进行 处 理 的 线程 的 名 称 ， 程 序 在 调用 parallelstrean 方法 之 
后 、sequential 方法 之 前 调用 peek。 输 出 如 下 : 
main processing 


6 
main processing 2 
main processing 8 
2 
1 
1 









































main processing 
main processing 
main processing 


可 以 看 到 ，maiin 线程 完成 了 所 有 的 处 理 。 换 言 之 ， 尽 管 调用 了 parallelstrean 方法 ， 但 返 
回 的 仍然 是 顺序 流 。 这 是 什么 原因 呢 ?” 读 者 或 许 还 记得 ， 流 在 达到 终止 表达 式 (terminal 
expression) 前 不 会 进行 任何 操作 ， 即 在 达到 终止 表达 式 时 才 会 评估 流 的 状态 。 在 本 例 中 ， 
由 于 collect 方法 之 前 最 后 调用 的 是 sequential 方法 ,程序 将 返回 顺序 流 ， 并 对 元 素 做 相 
应 处 理 。 


[eo 





流 在 执行 时 既 可 以 是 并 行 的 ， 也 可 以 是 顺序 执行 的 。parallel 或 sequential 
方法 能 有 效 地 设置 或 撤销 设置 一 个 布尔 值 ， 并 在 达到 终止 表达 式 时 进行 检查 。 























如 果 确 有 必要 以 并 行 方式 处 理 部 分 流 ， 而 以 顺序 方式 处 理 流 的 其 他 部 分 ， 建 议 使 用 两 个 单 
独 的 流 。 虽 然 这 样 处 理 也 存在 不 少 问题 ， 但 目前 尚 无 更 好 的 解决 方案 。 


























注 5: 可 以 这 样 理解 使 用 并 行 流 排序 意味 着 将 区 间 划 分 为 若干 相等 的 部 分 ， 然 后 分 别 对 每 部 分 排序 ， 再 
试 将 所 有 经 过 排序 的 子 区 间 合 并 在 一 起 。 那 么 从 整体 来 看 ， 最 终 的 输出 其 实 并 没有 实现 排序 。 








驮 
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9.2 ”并行 流 的 优点 


问题 

用 户 希望 了 解 并 行 流 的 优势 所 在 。 
方案 

在 合适 的 条 件 下 应 用 并 行 流 。 


讨论 

Stream API 能 方便 地 将 顺序 流转 换 为 并 行 流 ， 不 过 性 能 提升 与 否 需 要 视 情 况 而 定 。 请 记 
住 ， 切 换 到 并 行 流 是 一 种 优化 操作 ， 但 首先 应 保证 代码 可 以 正常 工作 ， 再 决定 是 否 有 必要 
使 用 并 行 流 。 建 议 根 据 实际 情况 进行 决策 。 

在 Java 8 中， 并 行 流 默认 使 用 通用 fork/join 线程 池 来 分 发 任务 。 线 程 池 大 小 等 于 JVM 可 
用 的 处 理 器 数量 ， 它 由 Runtime.getRuntime().availableProcessors() 确定 。" 无论 是 将 任 
务 分 解 为 多 个 子 任务 ， 还 是 将 所 有 子 任务 的 结果 合并 为 最 终 输 出 ， 都 会 为 fork/join 线程 池 
的 管理 引入 开销 。 

为 了 使 这 些 额 外 的 开销 物 有 所 值 ， 应 在 满足 以 下 要 求 时 再 使 用 并 行 流 : 

。 数据 量 较 大 

。 每 个 元 素 的 处 理 较为 耗 时 

。 数据 源 易 于 分 解 

。 操作 是 无 状态 且 关 联 的 

前 两 项 要 求 经 常 被 合 二 为 一 。 如 果 N 为 数据 元 素 的 数量 ，Q 为 每 个 元 素 所 需 的 计算 时 间 ， 
则 AN 与 9 的 乘积 通常 需要 超过 某 个 国 值 ， 使 用 并 行 流 才 可 能 获得 性 能 提升 “。 根 据 第 三 项 要 
求 ， 应 采用 易于 分 解 的 数据 结构 (如 数组 )。 最 后 ， 在 并 行 处 理 时 ， 如 果 操 作 是 有 状态 或 
有 序 的 ， 那 么 显然 会 出 现 问 题 。 


为 说 明 并 行 流 对 性 能 提升 的 效果 ， 我 们 来 看 一 个 最 简单 的 例子 。 如 例 9-6 所 示 ， 程 序 为 顺 
序 流 添加 了 为 数 不 多 的 几 个 整数 。 
例 9-6 为 顺序 流 添 加 整数 


public static int doubleIt(int n) { 
















































































































































































try { 
Thread. sleep(100); 0 
} catch (InterruptedException ignore) { 
} 
注 6: 严格 来 说 ， 线 程 池 大 小 应 为 处 理 器 数量 减 1。 但 如 果 将 主线 程 包括 在 内 ， 则 线程 池 大 小 与 处 理 器 数量 
相等 。 
注 7: 一 个 约定 俗 成 的 公式 是 N * Q > 10,699， 不 过 似乎 没有 人 会 使 用 很 大 的 @ 值 ， 因 此 很 难 解释 为 何 将 10 000 
作为 国 值 。 








return Nn * 2; 


} 
// 主线 程 


Instant before = Instant.now(); (2) 
total = IntStream.of(3, 1, 4, 1, 5, 9) 

.map(ParallelDemo: :doublelIt) 

.Sum(); 
Instant after = Instant.now(); 8 
Duration duration = Duration.between(start, end); 
System.out.println("Total of doubles = " + total); 
System.out.println("time = " + duration.toMillis() + " ms"); 


@ 人 为 引入 延迟 
@ 获取 倍增 前 后 的 时 间 
由 于 添加 数字 的 过 程 极 快 ， 除 非 人 为 引入 延迟 ， 否 则 难以 看 出 并 行 操作 对 性 能 提升 的 效果 。 
在 本 例 中 , N 是 如 此 之 小 (N = 6)， 因 此 通过 引入 100 毫秒 的 延迟 (sleep(100)) 来 扩展 Q。 
默认 情况 下 ，Java 创建 的 流 都 是 顺序 流 。 由 于 每 个 元 素 的 倍增 操作 都 延迟 100 毫秒 ， 处 理 
6 个 元 素 所 需 的 总 时 间 约 为 600 毫秒 。 程 序 的 实际 执行 结果 如 下 ; 
Total of doubles = 46 
time = 621 ms 
接 下 来 ， 我 们 对 代码 进行 微调 ， 改 为 使 用 并 行 流 。 如 例 9-7 所 示 ， 在 map 操作 前 插入 parallel 
方法 ， 其 他 代码 保持 不 变 。 
例 9-7 使 用 并 行 流 
total = IntStream.of(3, 1, 4, 1, 5, 9) 
.parallel() 0 
.map(ParallelDemo: :doubleIt) 
.Sum(); 
@ 使 用 并 行 流 
在 一 台 8 核 计算 机 上 ， 实 例 化 的 fork/join 线程 池 大 小 为 8。 换 言 之 ， 流 中 的 每 个 元 素 都 可 
以 被 分 配 一 个 CPU 核心 (假设 当前 没有 其 他 任务 ， 稍 后 将 讨论 )， 因 此 所 有 倍增 操作 基本 
会 同时 进行 。 
再 次 执行 程序 ， 结 果 如 下 : 
Total of doubles = 46 
time = 112 ms 
每 个 倍增 操作 延迟 100 毫秒 ， 且 有 足够 的 线程 对 每 个 数字 单独 处 理 ， 因 此 整个 计算 仅 需 100 
多 毫秒 就 能 完成 。 
1. 利用 JHM 计 时 
众所周知 ， 性 能 度量 绝 非 易 事 ， 它 与 缓存 、JVM 启动 时 间 等 多 种 因素 有 关 。 前 面 的 示例 只 










































































注 8: 线程 池 的 实际 大 小 为 7， 但 如 果 将 主线 程 包括 在 内 ， 则 有 8 个 独立 的 线程 。 
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是 粗略 估算 了 顺序 流 和 并 行 流 的 处 理 时 间 ， 如 果 希 望 获得 更 精确 的 测试 结果 ， 可 以 采用 筑 
基准 测试 框架 (micro-benchmarking framework)。 








JMH (Java Micro-benchmark Harness) 是 一 种 常用 的 Java 微 基准 测试 框架 ， 它 通过 注解 
(annotation) 来 设置 计时 模式 、 范 围 、JVM 参数 等 ee te 结果 如 
例 9-8 所 示 。 

例 9-8 利用 JMH 对 倍增 操作 计时 


import org.openjdk.jmh.annotations.*; 
































import java.util.concurrent.TimeUnit; 
import java.util.stream.IntStream; 


@BenchmarkMode(Mode.AverageTime) 
@OutputTimeUnit(TimeUnit.MILLISECONDS) 
@State(Scope.Thread) 
@Fork(value = 2, jvmArgs = {"-Xms4G", "-Xmx4G"}) 
public class DoublingDemo { 
public int doubleIt(int n) { 
try { 
Thread. sleep(100); 

} catch (InterruptedException ignored) { 

} 

return n * 2; 


} 


@Benchmark 
public int doubleAndSumSequential() { 
return IntStream.of(3, 1, 4, 1, 5, 9) 
.map(this: :doubleIt) 
.Sum(); 


} 


@Benchmark 
public int doubleAndSumparallel() { 
return IntStream.of(3, 1, 4, 1, 5, 9) 
.parallel() 
.map(this: :doubleIt) 
.Sum(); 


} 
根据 默认 设置 ,在 一 系列 预 热 迭 代 (warmup iteration)“ 后, JHM 将 在 两 个 独立 的 线程 中 执 
行 20 次 迭代 。 典 型 的 运行 结果 如 下 : 


Benchmark Mode Cnt Score Error Units 
DoublingDemo.doubleAndSumparallel avgt 40 103.523 + 0.247 ms/op 
DoublingDemo.doubleAndSumSequential avgt 40 620.242 + 1.656 ms/op 


可 以 看 到 ， 这 些 值 与 粗略 估算 的 结果 基本 相同 : 顺序 处 理 的 平均 耗 时 约 为 620 毫秒 ， 而 六 
行 处 理 的 平均 耗 时 约 为 103 毫秒 。 换 言 之 ， 只 要 处 理 器 的 数量 足够 多 ， 并 行 操作 就 能 为 6 
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注 9: 旨 在 优化 JIT， 让 系统 进入 稳定 状态 ， 以 便 测 试 结果 更 接近 实际 情况 。 一 一 译 者 注 
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个 数字 各 自分 配 一 个 单独 的 线程 ， 这 比 连续 执行 每 个 运算 的 速度 要 快 6 倍 。 
2. 对 基本 数据 类 型 求 和 
在 上 一 节 的 示例 中 ， 由 于 N 过 小 ， 为 体现 并 行 流 对 性 能 提升 的 效果 ， 我 们 人 为 引入 延迟 以 
扩展 Q。 接 下 来 ， 我 们 将 对 泛 型 流 (generic stream) 和 基本 类 型 流 (primitive stream) 的 迭 
代 操 作 、 并 行 操作 以 及 顺序 操作 进行 比较 ， 并 通过 较 大 的 N 值 观察 不 同 操作 的 性 能 。 








本 节 的 示例 并 不 复杂 ， 它 根据 经 典 教程 Mordern Java in Action (Second Edition)" 
中 一 个 类 似 的 示例 改编 而 成 。 





例 9-9 显示 了 采用 赤 代 方式 对 循环 中 的 数字 求 和 。 
例 9-9 采用 和 友 代 方式 对 循环 中 的 数字 求 和 


public Long iterativeSum() { 
Long result = 0; 
for (long i = 1L; i <= N; i++) { 
result += i; 


} 


return result; 


例 9-10 分 别 采用 顺序 方式 和 并 行 方式 对 Stream<Long> 求 和 。 


例 9-10 ”对 泛 型 流 求 和 
public long sequentialStreamSum() { 
return Stream.iterate(1L, i -> i + 1) 
.limit(N) 
.reduce(0OL, Long::sum); 


} 


public long parallelStreamSum() { 
return Stream.iterate(1L, i -> i + 1) 
.Limit(N) 
.parallel() 
.reduce(QOL, Long::sum); 


} 
paraLLeLStreamnSum 方法 遇 到 的 可 能 是 最 糟糕 的 情况 ， 因 为 它 返回 Stream<Long> 而 非 
LongSstream， 且 需要 处 理由 iterate 方法 产生 的 数据 集合 ， 而 它 不 易 分 解 。 
而 例 9-11 使 用 LongSstreanm 接口 (包括 一 个 sum 方 法 ) 定义 的 rangeClosed 方法 ， 有 助 于 
Java 分 区 。 


例 9-11 LongsStreanm 的 应 用 
public Long sequentialLongStreamSum() { 
return LongStream.rangeClosed(1, N) 

















注 10: 作者 为 Urma、Fusco 与 Mycroft， Manning Publications 于 2018 年 5 月 出 版 。( 该 书 第 1 版 中 文 版 
书 名 为 《Java 8 实战 》， 已 由 人 民 邮 电 出 版 社 出 版 ， 此 版 中 文 版 也 即将 推出 。 译 者 注 ) 
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.SUm( ) ; 


} 


public long parallelLongStreamSum() { 
return LongStream.rangeClosed(1, N) 

















.parallel() 

.Sum(); 
} 

利用 JHM 对 1000 万 个 元 素 (N = 10,669,699) 进行 测试 ， 儿 种 操作 的 测试 结果 如 下 : 

Benchmark Mode Cnt Score Error Units 
iterativeSum avgt 40 6.441 + 0.019 ms/op 
sequentialStreamSum avgt 40 90.468 + 0.613 ms/op 
parallelStreamSum avgt 40 99.148 + 3.065 ms/op 
sequentialLongStreamSum avgt 40 6.191 + 0.248 ms/op 
parallelLongStreamSum avgt 40 6.571 + 2.756 ms/op 





可 以 看 到 ， 装 箱 和 拆 箱 操作 引入 了 不 少 开销 。 使 用 Stream<Long> (而 非 LongStream) 
的 paraLLeLStreamSum 和 sequentiaLStreamSum 操作 非常 慢 ， 加 之 由 iterate 方 法 产生 
的 数据 集合 不 易 分 解 ， 速 度 问 题 更 加 突出 。LongStream.rangeClosed 方 法 则 快 得 多 ， 
sequentialLongStreamSum 和 parallelLongStreamSum 操作 在 性 能 上 几乎 没有 差别 。 


9.3 调整 线程 池 大 小 


问题 

用 户 希望 在 通用 线程 池 中 自 定义 线程 数量 ， 而 不 是 使 用 默认 大 小 的 线程 地。 

方案 

适当 调整 系统 参数 ， 或 将 任务 提交 到 自 定 义 的 ForkJoinPool 实例 。 

讨论 

根据 Javadoc 对 java.util.concurrent.ForkJoinPool 类 的 描述 ， 可 以 通过 以 下 三 种 系统 属 
性 控制 通用 线程 池 的 构建 : 


。 java.util.concurrent.ForkJoinpPool.common.parallelism 




















。 java.util.concurrent.ForkJoinpool.common.threadFactory 


。 java.util.concurrent.ForkJoinpPool.common.exceptionHandler 
之 前 曾经 提 到 过 ， 上 默认 情况 下 ， 通 用 线程 池 大 小 等 于 JVM 上 可 用 的 处 理 器 数量 ， 它 
Runtime.getRuntime().availableProcessors() 确定 。parallelisnm 标志 用 于 指定 并 和 a 


(parallelism level)， 它 是 一 个 非 负 整数 ， 可 以 通过 编程 方式 或 命令 行 方式 来 设置 。 例 9-12 
显示 了 如 何 采 用 System.setProperty 方法 创建 所 需 的 并 行 级 别 。 
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例 9-12 采用 编程 方式 设置 通用 线程 池 大 小 


System.setProperty( 
"java.util.concurrent.ForkJoinpPool.common.parallelism", "20"); 
Long total = LongStream.rangeClosed(1, 3_000_000) 
.parallel() 
.Sum(); 
int poolSize = ForkJoinpool.commonPool().getPoolSizel(); 
System.out.println("Pool size: " + poolSize); © 


@ 打印 Pool size: 20 








将 通用 线程 地 大 小 设置 为 大 于 可 用 的 CPU 核心 数 无 助 于 性 能 提升 ，"。 





在 命令 行 中 ， 可 以 像 使 用 任何 系统 属性 一 样 使 用 -0 标志 。 请 注意 ， 编 程 设置 将 覆盖 命令 
行 设置 ， 如 例 9-13 所 示 。 
例 9-13 采用 系统 参数 设置 通用 线程 池 大 小 

$ java -cp build/classes/main concurrency.CommonPooLSize 


Pool size: 20 


// 注释 掉 System.setProperty("java.util.concurrent.ForkJoinPool.common.parallelism", "20"); 
$ java -cp build/classes/main concurrency.CommonPooLSize 
Pool size: 7 


$ java -cp build/classes/main \ 
-Djava.util.concurrent.ForkJoinpool.common.parallelism=10 \ 
Concurrency.CommonPooLSize 

Pool size: 10 


本 例 在 一 台 8 核 计 算 机 上 运行 。 默 认 的 线程 地 大 小 为 7， 但 如 果 将 maiin 线程 包括 在 内 ， 则 
默认 情况 下 共有 8 个 活动 线程 。 

自 定义 ForkJoinPool 

ForkJoinPool 类 定义 了 一 个 构造 函数 ， 它 传 和 一 个 整数 作为 并 行 级 别 。 我 们 可 以 借 此 创建 
有 别 于 通用 线程 凶 的 自 定 义 线程 地 ， 并 将 任务 提交 给 它 。 


例 9-14 显示 了 如 何 创建 自 定 义 线程 池 。 
例 9-14 创建 自 定义 ForkJoinpool 




















ForkJotinPooL pool = new ForkJoinpool(15); 0 
ForkjJoinTask<Long> task = pool.submit( @ 
() -> LongStream.rangeClosed(1, 3_000_000) 

.parallel() 
.sum()); 
try { 





注 11: 关于 不 同 并 发 实现 的 性 能 比较 ，Alex Zhitnitsky 在 ForkWoin Framework vs. Parallel Streams vs. ExecutorService: 
The Ultimate Fork/Join Benchmark 一 文中 做 了 深入 讨论 。 一 一 译 者 注 
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total = task.get(); 【3) 

} catch (InterruptedException | ExecutionException e) { 
e.printStackTrace(); 

} finally { 
pool. shutdown(); 


FE 
poolSize = pool.getPoolSize(); 
System.out.println("Pool size: " + poolSize); @ 


@ 实例 化 一 个 大 小 为 15 的 ForkJoinPool 
@ 提交 catllable<Long> 作为 任务 

@ 执行 任务 并 等 待 回复 

@ 打印 Pool size: 15 


大 部 分 情况 下 ， 在 流 上 调用 parattet 方法 时 所 用 的 通用 线程 池 都 能 满足 要 求 。 如 果 需 要 改 
变 其 大 小 ， 请 调整 系统 属性 ， 如 有 果 仍 然 无 法 满足 要 求 ， 请 尝试 创建 自 定义 ForkJoinPool 并 


将 任务 提交 给 它 。 


无 论 如 何 ， 在 确定 采用 何 种 长 期 解决 方案 之 前 ， 请 务必 收集 相关 的 性 能 数据 。 





























另 见 
通过 自 定义 线程 池 实 现 并 行 计算 的 男 一 种 方案 是 采用 CompletableFuture， 相 关 讨 论 请 参见 
范例 9.5。 


9.4 Future 接 口 





问题 
用 户 希望 执行 表示 异步 计算 结果 、 检 查 计算 是 否 完成 、 在 必要 时 取消 计算 、 检 索 计 算 结 果 
等 操作 。 


方案 

使 用 能 实现 java.util.concurrent.Future 接口 的 CompletableFuture 类 。 

讨论 

在 本 书 介绍 的 Java 8 和 Java 9 新 特性 中 ，CompletableFuture 是 一 种 非常 有 用 的 类 。 由 于 
CompletableFuture 类 可 以 实现 Future 接口 ， 我 们 有 必要 对 这 种 接口 的 用 法 做 一 简要 回顾 。 


Java 5 引入 的 java.util.concurrent 包 让 开发 人 员 可 以 在 更 高 的 抽象 层次 上 操作 并 发 ， 
而 不 仅 限于 使 用 简单 的 wait 和 notify 原 语 。java.util.concurrent 包 定 义 了 一 种 名 为 
ExecutorService 的 接口 ， 其 submit 方法 传 入 Callable， 并 返回 包装 所 需 对 和 象 的 Future。 


如 例 9-15 所 示 ， 程 序 将 任务 提交 给 Executorservice 并 打印 字符 串 ， 然 后 在 Future 中 检索 值 。 
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例 9-15 提交 Callable 并 返回 Future 
ExecutorService service = Executors.newCachedThreadPool(); 
Future<String> future = service.submit(new Callable<String>() { 
@Override 
public String call() throws Exception { 
Thread. sleep(100); 
return "Hello, World!"; 
} 
3 
System.out.println("Processing..."); 
getIfNotCancelled(future); 


例 9-16 显示 了 getIfNotCancelled 方法 的 应 用 。 
例 9-16 在 Future 中 检索 值 


public void getIfNotCanceLLed(Future<String> future) { 





try { 
if (!future.isCancelled()) { 0 
System.out.println(future.get()); 人 名 
} etLse { 
System.out.println("Cancelled"); 
} 


} catch (InterruptedException | ExecutionException e) { 
e.printStackTrace(); 
} 
} 


@ 检查 Future 的 状态 

@ 通过 阻塞 调用 以 检索 Future 的 值 

在 本 例 中 ，isCancetLted 方法 的 用 途 不 言 自 明 ，9get 方法 用 于 在 Future 中 检索 值 ， 该 方法 
属于 阻塞 调用 (blocking call)， 返回 的 是 其 内 部 的 泛 型 类 型 ，getIfNotCancelled 方法 采用 
try/catch 代码 块 处 理 声明 的 异常 。 

输出 结果 如 下 : 


Processing... 
Hello, World! 


由 于 所 提交 的 调用 会 立即 返回 Future<String>， 程 序 将 马上 打印 “Processing...”。 之 后 调 
用 get 代码 块 直到 Future 完成 ， 并 打印 结果 。 


既然 本 书 重点 讨论 Java 8， 我 们 不 妨 采用 lambda 表达 式 蔡 换 Catlable 接口 的 匿名 内 部 类 
实现 ， 如 例 9-17 所 示 。 


例 9-17 使 用 lambda 表达 式 并 检查 Future 是 否 完成 
future = service.submit(() -> { 0 
Thread. sleep(10); 
return "Hello, World!"; 


}); 





























System.out.println("More processing..."); 





大 
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while (!future.isDone()) { @ 
System.out.println("Waiting..."); 


} 


getIfNotCancelled(future); 


@ 使 用 lambda 表达 式 替 换 callable 

@ 等 待 Future 完成 

可 以 看 到 ， 除 使 用 lambda 表达 式 之 外 ， 程 序 还 在 whtte 循环 中 调用 tspone 方法 以 轮 询 
Future， 直 至 它 完成 。 


在 循环 中 使 用 isDone 方法 称 为 忙 等 待 (busy waiting) ， 由 于 该 方法 可 能 产生 
数 百 万 次 调用 ， 通常 属 于 应 该 避免 的 操作 。'CompletableFuture 类 ( 详 见 范 
例 9.5、 范 例 9.6 与 范例 9.7) 可 以 在 Future 完成 时 提供 更 好 的 处 理 方 式 。 






































例 9-17 的 输出 结果 如 下 : 


More processing... 
Waiting... 
Waiting... 
Waiting... 
// 一 直 等 竺 
Waiting... 
Waiting... 
Hello, World! 


当 某 个 Future 完成 时 ， 程 序 显 然 需要 一 种 更 有 效 的 方式 来 通知 开发 人 员 ， 计 划 将 这 个 
Future 的 结果 用 于 其 他 操作 时 更 是 如 此 。CompletableFuture 类 的 作用 就 在 于 此 。 


此 外 ， 可 以 通过 Future 接口 定义 的 cancel 方法 取消 操作 ， 如 例 9-18 所 示 。 
例 9-18 取消 Future 


future = service.submit(() -> { 
Thread.sleep(10); 
return "Hello, World!"; 


}); 

















el 














future.cancel(true); 
System.out.printLn("Even more processing..."); 


getIfNotCancelled(future); 


输出 结果 如 下 : 
Even more processing... 
Cancelled 

















注 12: 某 些 情况 下 可 能 需要 忙 等 待 ， 如 广泛 用 于 操作 系统 内 核 的 自 旋 锁 (spinlock)。 不 过 ， 自 旋 锁 的 持 有 
时 间 过 长 会 阻止 其 他 线程 运行 ， 导 致 系统 性 能 降低 。 一 一 译 者 注 
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由 于 CompletableFuture 类 实现 了 Future 接口 ， 本 范例 讨论 的 所 有 方法 同样 适用 于 
CompletableFuture 类 。 





号 
另 见 
有 关 CompletableFuture 的 讨论 请 参见 范例 9.5、 范 例 9.6 与 范例 9.7。 


9.5 完成 CompLetabLeFuture 


问题 


用 户 希 望 显 式 地 完成 CompletableFuture， 要 么 设置 它 的 值 ， 要 么 在 调用 get 方法 时 使 其 抛 
出 异常 。 


方案 


使 用 CompletableFuture 类 定义 的 completedFuture、complete 或 completeExceptionally 方法 。 


讨论 
CompletableFuture 类 不 仅 能 实现 Future 接口 ， 也 能 实现 CompletionStage 接口 ， 它 定义 的 
数 十 种 方法 可 以 满足 各 种 需要 。 


CompletableFuture 类 的 最 大 优势 在 于 无 须 编写 能 套 回 调 (nested callback) 就 能 协调 操作 ， 相 关 
讨论 请 参见 范例 9.6 和 范例 9.7。 本 范例 将 探讨 如 何在 已 有 返回 值 时 完成 CompletableFuture。 


假设 我 们 的 应 用 程序 需要 根据 产品 ID 检索 相关 产品 。 由 于 涉及 某 种 形式 的 远程 访问 ， 检 
索 过 程 可 能 会 引入 大 量 开销 。 这 些 开 销 包 括 对 RESTful Web 服务 的 网 络 调用 、 数 据 库 调用 
以 及 其 他 相对 耗 时 的 操作 。 

为 此 ， 我 们 采用 映射 的 形式 在 本 地 创建 产品 缓存 : 请 求 某 个 产品 时 ， 系 统 首先 在 映射 中 检 
索 。 如 果 返 回 nuLL， 再 进行 开销 较 大 的 操作 。 例 9-19 显示 了 通过 本 地 和 远程 两 种 方式 来 
检索 产品 。 

例 9-19 产品 检索 


private Map<Integer, Product> cache = new HashMap<>(); 
private Logger Logger = Logger.getLogger(this.getClass().getName()); 





















































private Product getLocal(int id) { 
return cache.get(id); 0 


private Product getRemote(int id) { 
try { 
Thread. sleep(100); @ 
if (id == 666) { 
throw new RuntimeException("Evil request"); ©@ 





} 


} catch (InterruptedException ignored) { 
站 


return new Product(id, "name"); 
} 
@ 立即 返回 ， 但 可 能 为 null 
@ 人 为 引入 延迟 ， 然 后 检索 


@ 模拟 网 络 、 数 据 库 或 其 他 形式 的 错误 








接 下 来 ， 我 们 创建 一 个 名 为 getProduct 的 方法 ， 传 入 产品 ID 作为 参数 ， 并 返回 相应 的 产 
品 。 不 过 ， 如 果 将 返回 类 型 设置 为 CompletableFuture<Product>，getProduct 方法 将 立即 

















返回 ， 而 在 实际 的 检索 过 程 中 ， 程 序 还 可 以 处 理 其 他 任务 。 











为 此 ， 需 要 通过 某 种 方式 来 完成 CompletableFuture。CompletableFuture 类 定义 了 三 种 相 


关 的 方法 : 
boolean complete(T value) 
static <U> CompletableFuture<U> completedFuture(U value) 
boolean completeExceptionally(Throwable ex) 





如 果 已 有 CompletableFuture 且 希 望 将 其 设置 为 给 定 的 值 ， 可 以 采用 complete 方 法 ，; 
CompLetabLeFuture 方法 是 一 种 工厂 方法 , 它 使 用 给 定 的 值 创建 一 个 新 的 CompletableFuture; 





completeExceptionally 方法 使 用 给 定 的 异常 来 结束 Future。 





例 9-20 显示 了 上 述 三 种 方法 的 应 用 。 程 序 假定 存在 一 种 从 远程 系统 返回 产品 的 遗留 机 制 ， 


希望 使 用 这 种 机 制 完成 Future。 


例 9-20 完成 CompletableFuture 
public CompletableFuture<Product> getProduct(int id) { 
try { 
Product product = getLocal(id); 
if (product != nuLL) { 
return CompletableFuture.completedFuture(product); © 


} elsef{ 
CompletableFuture<Product> future = new CompletableFuture<>(); 
Product p = getRemote(id); @ 
cache.put(id, p); 
future.complete(p); © 


return future; 
} 
} catch (Exception e) { 
CompletableFuture<Product> future = new CompletableFuture<>(); 
future.completeExceptionally(e); @ 
return future; 


} 
@ 在 缓存 中 检索 到 产品 (如果 有 的 话 ) 后 完成 
@ 遗留 检索 方式 
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@ 在 执行 遗留 检索 方式 后 完成 (异步 操作 的 情况 参见 例 9-22) 
@ 如 果 出 现 问题 ， 在 抛 出 异常 后 完成 


在 本 例 中 ，getProduct 方法 首先 尝试 在 缓存 中 检索 产品 。 如 果 映 射 返 回 非 空 值 ， 则 使 用 工 
厂 方法 completedFuture 返回 该 值 。 


如 果 缓 存 返 回 nuLL， 说 明 需 要 进行 远程 访问 。 程 序 模拟 了 一 种 可 能 是 遗留 代码 的 同步 方案 
稍 后 将 详细 讨论 。CompletableFuture 类 被 实例 化 ，complete 方法 采用 生成 的 值 进行 填充 。 
最 后 ， 如 果 出 现 严 重 问题 (将 ID 设置 为 666 以 便 模 拟 )， 程 序 将 抛 出 RuntimeException。 
completeExceptionally 方法 传 入 RuntimeException 作为 参数 ， 并 使 用 该 异常 结束 Future。 
例 9-21 的 测试 用 例 显示 了 异常 处 理 的 工作 方式 。 

例 9-21 completeExceptionally 方法 的 应 用 


QTest(expected = ExecutionException.class) 
public void testException() throws Exception { 
demo .getProduct(666).get(); 












































} 
@Test 
public void testExceptionWithCause() throws Exception { 

try { 
demo.getProduct(666).get(); 
fail("Houston, we have a problenm..."); 

} catch (ExecutionException e) { 
assertEquals(ExecutionException.class, e.getClass()); 
assertEquals(RuntimeException.class, e.getCause().getClass()); 

} 

} 


上 述 两 项 测试 均 能 通过 。 在 CompletableFuture 上 调用 completeExceptionally 方法 时 ，get 
方法 将 抛 出 ExecutionException， 这 是 由 首先 导致 问题 的 异常 (本 例 为 RuntimeException) 
所 引起 的 。 





get 方法 抛 出 的 ExecutionException 是 一 个 受 检 蜡 常 (checked exception)。 
join 方法 与 get 方法 相同 ， 不 同 之 处 在 于 ， 如 果 异 常 完成 ，join 方法 将 抛 出 
由 底层 异常 所 引发 的 CompletionException， 它 是 一 个 非 受 检 异 常 (unchecked 


exception ) 。 











在 例 9-20 中 ， 最 有 可 能 替换 的 是 执行 产品 同步 检索 的 那 部 分 代码 。 为 此 ， 可 以 使 用 
CompletableFuture 类 定义 的 另 一 种 静态 工厂 方法 suppLyAsync， 它 包括 以 下 形式 : 
static CompletableFuture<Void> runAsync(Runnable runnable) 


static CompletableFuture<Void> runAsync(Runnable runnable, 
Executor executor) 


static <U> CompLetabLeFuture<U> supplyAsync(Supplier<U> supplier) 
static <U> CompLetabLeFuture<U> supplyAsync(Supplier<U> supplier, 
Executor executor) 




















supplyAsync 方法 返回 一 个 使 用 给 定 Supplier 的 对 象 ， 如 果 不 需 要 返回 对 象 ， 则 使 用 
runAsync 方法 更 方便 。 两 种 方法 的 单 参数 形式 使 用 默认 的 通用 fork/join 线程 地 ， 而 双 参 数 
形式 使 用 给 定 的 执行 器 (executor) 作为 第 二 个 参数 。 


例 9-22 显示 了 采用 异步 模式 检索 产品 。 
例 9-22 利用 supplyAsync 方法 检索 产品 


public CompletableFuture<Product> getProductAsync(int id) { 
try { 
Product product = getLocal(id); 
if (product != nuLL) { 
Logger .info("getLocaL with id=" + id); 
return CompletableFuture.completedFuture(product); 
} elsef{ 
Logger .info("getRemote with id=" + id); 











return CompletableFuture.supplyAsync(() -> { 0 
Product p = getRemote(id); 
cache.put(id, p); 
return p; 


了 


} catch (Exception e) { 
Logger .info("exception thrown"); 
CompletableFuture<Product> future = new CompletableFuture<>(); 
future.completeExceptionally(e); 
return future; 


} 
@ 与 之 前 的 操作 相同 ， 但 采用 异步 模式 返回 检索 到 的 产品 
可 以 看 到 ， 程 序 在 实现 Supplier<Product> 的 lambda 表达 式 中 检索 产品 。 我 们 总 是 可 以 将 
其 作为 独立 的 方法 提取 出 来 ， 并 将 代码 简化 为 一 个 方法 引用 。 
不 过 ， 如 何在 CompletableFuture 完成 之 后 调用 其 他 操作 颇 费 周章 。 有 关 多 个 CompletableFuture 
实例 之 间 的 协调 请 参见 范例 9.6。 














另 见 
本 范例 的 示例 以 Kenneth Jgrgensen 在 其 博文 中 讨论 的 一 个 类 似 示例 为 基础 。” 


9.6 ”多 个 CompletableFuture 之 间 的 协调 〈 第 1 部 分 ) 


问题 
用 户 希 望 在 一 个 Future 完成 之 后 触发 男 一 个 动作 (action)。 











性 
mH 
王 
LD 


: 参见 Kenneth Jgrgensen 博客 上 题 为 “Introduction to CompletableFutures” 的 博文 。 
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方案 
使 用 CompletableFuture 类 中 用 于 协调 动作 的 各 种 实例 方法 ， 如 thenAppLy、thenCompose、 


thenRun 等 。 


讨论 

CompletableFuture 类 的 最 大 优势 在 于 能 很 容易 地 将 多 个 Future 链接 起 来 。 我 们 可 以 创 
建 多 个 Future 以 表示 需要 执行 的 各 种 任务 ， 然 后 通过 一 个 Future 的 完成 来 触发 另 一 个 
Future 的 执行 ， 达 到 协调 动作 的 目的 。 


我 们 考虑 如 何 实现 下 面 这 个 简单 的 任务 : 


。 向 Supplier 请 求 一 个 包含 数字 的 字符 串 
。 将 数字 解析 为 整数 
。 将 整数 倍增 


。 打印 倍增 后 的 结果 
相关 实现 如 例 9-23 所 示 ， 程 序 并 不 复杂 。 
例 9-23 利用 CompletableFuture 协调 多 个 任务 


private String sleepThenReturnString() { 


try { 
Thread. sleep(100); 0 
} catch (InterruptedException ignored) { 


























return "42"; 


} 


CompletableFuture. supplyAsync(this: :sleepThenReturnString) 
.thenApply(Integer::parseInt) 
.thenApply(x -> 2 * x) 
.thenAccept(System.out: :println) 
.join(); 

System.out.println("Running..."); 


@ 人 为 引入 延迟 

@ 在 前 一 阶段 完成 后 应 用 Function 
@ 在 前 一 阶段 完成 后 应 用 Consumer 
@ 检索 完成 的 结果 


由 于 对 join 的 调用 属于 阻塞 调用 ， 执 行 上 述 程序 将 输出 84 并 后 跟 “Running...”。supplyAsync 
方法 传人 Supplier (本 例 为 String 类 型 )。thenApply 方法 传人 Function， 其 输入 参数 为 
前 一 个 CompLetionstage 的 结果 。 其 中 第 一 个 thenApply 方法 中 的 函数 将 字符 串 转 换 为 一 个 
整数 ， 第 二 个 thenApply 方法 中 的 函数 将 整数 倍增 。 最 后 ，thenAccept 方法 传人 Consumer， 
在 前 一 个 阶段 完成 后 执行 。 


O@OOO 























CompletableFuture 类 定义 了 多 种 不 同 的 协调 方法 ， 完 整 列 表 〈 不 包括 重 载 形 式 ， 将 在 之 后 


讨论 ) 如 表 9-1 所 示 。 


表 9-1: CompletableFuture 类 定义 的 协调 方法 








修饰 符 ”返回 类 型 方法 名 参数 
CompletableFuture<Void> acceptEither CompletionStage<? extends T> other, 
Consumer<? super T> action 
static CompletableFuture<Void> allof CompletableFuture<?>... cfs 
static CompLetabLeFuture<0bject> anyOf CompletableFuture<?>... cfs 
<U> CompletableFuture<U> applyToEither CompletionStage<? extends T> other, 
Function<? super T, U> fn 
CompletableFuture<Void> runAfterBoth CompletionStage<?> other, Runnable 
action 
CompletableFuture<Void> thenAccept Consumer<? super T> action 
<U> CompletableFuture<U> thenApply Function<? super T> action, ? extends U> 
fn 
<U,V> CompletableFuture<V> thenCombine CompletionStage<? extends U> other, 
BiFunction<? super T, ? super U, 7? 
extends V> fn 
<U> CompletableFuture<U> thenCompose Function<? super T, ? extends 
CompletionStage<U>> fn 
CompletableFuture<Void> thenRun Runnable action 
CompletableFuture<T> whenComplete BiConsumer<? super T, ? super Throwable> 


action 


上 表 列 出 的 所 有 方法 均 使 用 工作 者 线程 (worker thread) 的 通用 ForkJoinPool， 其 大 小 与 
处 理 器 数量 相等 。 前 面 已 经 讨论 过 工厂 方法 runAsync 和 suppLyAsync， 二 者 指定 Runnable 
或 Supplier， 并 返回 CompletableFuture。 如 上 表 所 示 ， 可 以 通过 链接 其 他 方法 (如 
thenApply 或 thenCompose) 来 添加 将 在 前 一 个 任务 完成 后 开始 执行 的 任务 。 


表 9-1 并 未 列 出 每 种 方法 包含 的 其 他 两 种 模式 ， 二 者 以 Async 结尾 ， 一 种 传人 Executor， 
而 另 一 种 不 传 入 。 以 thenAccept 方法 为 例 ， 其 完整 形式 如 下 : 
CompletableFuture<Void> thenAccept(Consumer<? super T> action) 
CompletableFuture<Void> thenAcceptAsync(Consumer<? super T> action) 


CompletableFuture<Void> thenAcceptAsync( 
Consumer<? super T> action, Executor executor) 


第 一 种 形式 在 与 原 有 任务 相同 的 线程 中 执行 其 Consumer 参数 ， 第 二 种 形式 将 Consumer 
再 次 提交 给 线程 地 ， 第 三 种 形式 提供 一 个 Executor ， 用 于 运行 任务 而 非 通用 fork/join 线 


























程 池 。 





是 否 采用 这 些 方 法 的 Async 形式 应 视 情 况 而 定 。 尽 管 异步 操作 能 加 快 单个 任 
务 的 执行 速度 ， 但 引入 的 开销 可 能 无 助 于 整体 速度 的 提升 。 








并 行 与 并 发 | 183 


由 于 ExecutorService 接口 实现 了 Executor 接口 ， 我 们 也 可 以 使 用 自 定 义 Executor 而 不 是 
通用 线程 池 。 例 9-24 显示 了 利用 单独 的 线程 池 执 行 CompletableFuture 任务 。 


例 9-24 在 单独 的 线程 池 中 运行 CompletableFuture 任务 
ExecutorService service = Executors.newFixedThreadPool(4); 
CompletableFuture.supplyAsync(this::sleepThenReturnString, service) 0 
.thenApply(Integer::parseInt) 
.thenApply(x -> 2 * x) 
.thenAccept(System.out: :println) 
.join(); 
System.out.println("Running..."); 


@ 提供 单独 的 线程 池 作 为 参数 


在 本 例 中 ，thenApply 和 thenAccept 方法 使 用 的 线程 与 suppLyAsync 方法 相同 。 不 过 ， 如 
果 使 用 thenApplyAsync 方法 ， 那 么 除非 添加 另 一 个 线程 池 作 为 附加 参数 ， 否 则 任务 将 被 提 
交 到 线程 池 。 





























在 通用 ForkJoinPool 中 等 待 完成 


默认 情况 下 ，CompletableFuture 使 用 所 谓 的 “通用 ”fork/join 线程 池 ， 后 者 是 一 种 经 

过 优化 并 执行 工作 窃取 (work stealing) 的 线程 池 。 根 据 Javadoc 的 描述 ， 这 种 线程 池 

中 的 所 有 线程 “尝试 查找 并 执行 提交 到 线程 池 或 由 其 他 活动 任务 创建 的 任务 ”。 需 要 注 

意 的 是 ， 所 有 工作 者 线程 均 为 守护 线程 (daemon thread) : 如 果 在 线程 结束 前 退出 程 

序 ， 线程 将 终止 。 

换言之 ， 在 执行 例 9-23 所 示 的 代码 时 ， 如 果 没 有 调用 join 方法， 程序 将 只 打印 

“Running...”， 而 不 会 输出 Future 的 结果 ， 系 统 在 任务 完成 前 即 告终 止 。 

可 以 采用 两 种 方案 解决 这 个 问题 。 一 种 方案 是 调用 get 或 join 方法 ， 二 者 将 阻塞 调 

用 进程 ， 直 至 检索 到 结果 。 另 一 种 方案 是 为 通用 线程 池 设 置 一 个 超时 时 间 (time-out 

period) ， 告 诉 程序 等 待 直至 所 有 线程 执行 完毕 : 
ForkJoinpool.commonPool().awaitQuiescence(long timeout, TimeUnit unit) 

如 果 将 线程 池 的 等 待 周期 设置 得 足够 长 ，Future 就 会 完成 。awaitQuiescence 方法 用 于 通 

知 系统 等 待 ， 直 至 所 有 工作 者 线程 空 闸 ， 或 所 设置 的 超时 时 间 结 束 (以 先 到 者 为 准 )。 











对 于 返回 值 的 CompletableFuture 实例 ， 可 以 通过 get 或 join 方法 检索 该 值 。 两 种 方法 
属于 阻塞 调用 ， 直 至 Future 完成 或 抛 出 异常 。 不 同 之 处 在 于 ，get 方法 抛 出 的 是 受 检 蜡 
常 ExecutionException， 而 join 方法 抛 出 的 是 非 受 检 异 常 CompletionException， 因 此 在 
lambda 表达 式 中 更 容易 使 用 join 方法 。 

cancel 方法 用 于 取消 CompletableFuture， 该 方法 传人 一 个 布尔 值 作为 参数 : 


boolean cancel(boolean mayInterruptIfRunning) 


如 果 CompletableFuture 尚未 完成 ，cancel 方法 将 利用 CancellationException 使 其 完成 ， 所 
有 依赖 的 CompletableFuture 也 会 由 于 CancellationException 引发 的 CompletionException 

















-A 
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而 异常 完成 。 此 时 ， 布 尔 参数 不 执行 任何 操作 。” 


之 前 的 示例 介绍 了 thenApply 和 thenAccept 方法 的 应 用 。 而 thenCompose 是 一 种 实例 方法 ， 
可 以 将 某 个 Future 链接 到 原 有 Future， 使 得 第 一 个 Future 的 结果 也 能 用 于 第 二 个 Future。 
thenCompose 方法 的 应 用 如 例 9-25 所 示 ， 这 可 能 是 实现 两 个 数 相 加 的 最 复杂 的 程序 了 。 


例 9-25 两 个 Future 的 复合 


QTest 

public void compose() throws Exception { 
int x = 2; 
int y = 3; 


CompLetabLeFuture<Integer> completableFuture = 
CompLetabLeFuture.suppLyAsync(() -> x) 
.thenCompose(n -> CompletableFuture.supplyAsync(() -> n + y)); 


assertTrue(5 == completableFuture.get()); 


} 


thenCompose 方法 的 参数 是 一 个 函数 ， 它 传 入 第 一 个 Future 的 结果 ， 并 将 其 转换 为 第 二 个 
Future 的 输出 。 不 过 ， 如 果 和 希望 两 个 Future 彼此 独立 ， 可 以 改 用 thenCombine 方法 ， 如 
例 9-26 所 示 。5 


例 9-26 两 个 Future 的 合并 

















QTest 

public void combine() throws Exception { 
int x = 2; 
int y = 3; 


CompletableFuture<Integer> completableFuture = 
CompLetabLeFuture.suppLyAsync(() -> x) 
.thenCombine(CompletableFuture.supplyAsync(() -> y)， 
(n1，n2) -> n1 + n2); 


assertTrue(5 == completableFuture.get()); 


} 
thenCombine 方法 传 入 Future 和 BiFunction 作为 参数 。 计 算 结 果 时 ， 两 个 Future 的 结果 都 
能 在 国 数 中 使 用 。 
CompletableFuture 类 还 定义 了 一 种 名 为 handle 的 方法 ， 其 签名 如 下 : 

<U> CompletableFuture<U> handle(BiFunction<? super T, Throwable, ? extends U> fn) 
BiFunction 的 两 个 输入 参数 为 Future 的 结果 (正常 完成 ) 和 抛 出 的 异常 (异常 结束 )， 返 
回 的 参数 由 程序 决定 。handle 方法 也 有 两 种 Async 模式 ， 一 种 传人 BiFunction， 另 一 种 传 
入 BiFunction 和 Executor。handle 方法 的 应 用 如 例 9-27 所 示 。 


例 9-27 handle 方 法 的 应 用 


private CompletableFuture<Integer> getIntegerCompletableFuture(String num) { 
return CompletableFuture.supplyAsync(() -> Integer.parseInt(num)) 

















注 14: 有 趣 的 是 , 根据 Javadoc 的 描述 , 参数 mayInterruptIfRunning“ 不 起 作用 
注 15; 好 吧 ， 这 同样 可 能 是 实现 两 个 数字 相 加 的 最 复杂 的 程序 。 


为 中 断 不 用 于 控制 处 理 ”。 
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.handle((val, exc) -> val != null ? val : 0); 


} 

@Test 

public void handleWithException() throws Exception { 
String num = "abc"; 


CompletableFuture<Integer> vaLue = getIntegerCompletableFuture(num); 
assertTrue(vaLue.get() == 0); 


} 


@Test 

public void handleWithoutException() throws Exception { 
String num = "42"; 
CompletableFuture<Integer> vaLue = getIntegerCompletableFuture(num); 
assertTrue(vaLue.get() == 42); 


} 
本 例 解析 字符 串 以 查找 相应 的 整数 。 解 析 成 功 则 返回 整数 ， 解 析 失 败 则 抛 出 
ParseException，handle 方法 返回 0。 上述 两 个 测试 表明 ，handte 方法 能 正确 处 理 这 两 种 
情况 。 
从 上 面 这 些 示例 不 难看 到 ， 可 以 通过 多 种 方式 在 通用 线程 池 或 自 定义 执行 器 中 同步 或 异步 地 
合并 多 个 任务 。 范 例 9.7 将 给 出 一 个 更 复杂 的 示例 ， 讨 论 如 何 协 调 多 个 CompletableFuture。 












































另 见 
有 关 如 何 协调 多 个 CompletableFuture， 范 例 9.7 给 出 了 一 个 更 复杂 的 示例 。 


9.7 ”多 个 CompletableFuture 之 间 的 协调 (第 2 部 分 ) 


问题 

用 户 希望 通过 更 复杂 的 示例 了 解 如 何 协调 多 个 CompletableFuture 实例 。 

方案 

在 美国 职 棱 大 联盟 (MLB) 赛季 的 每 个 比赛 日 访问 官方 网 站 ， 其 中 包括 指向 当日 比赛 的 链 
接 。 下 载 每 场 比赛 的 技术 统计 信息 (box score) ， 并 将 其 转换 为 一 个 Java 类 。 采 用 异步 方 
式 保 存 数 据 后 计算 每 场 比赛 的 结果 ， 找 出 总 分 最 高 的 比赛 ， 然 后 打印 最 高 分 以 及 出 现 最 高 
分 的 那 场 比赛 。 

讨论 

较 之 其 他 简单 的 示例 ， 本 范例 所 讨论 的 应 用 程序 更 为 复杂 。 和 希望 读者 能 从 中 受到 启发 ， 理 
解 如 何 通 过 合并 多 个 CompletableFuture 任务 来 完成 工作 。 
































MLB 官方 网 站 保存 了 指定 比赛 日 中 每 场 比赛 的 得 分 ， 我 们 的 应 用 程序 即 以 此 为 基础 。” 以 





2017 年 6 月 14 日 为 例 ,包括 当日 所 有 比赛 信息 的 页 面 如 图 9-1 所 示 。 
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。 Parent Directory 





















































。 batters/ 
epg.XII 
gid 2017 06 14 arimlb detmlb 1/ 
gid 2017 06 14 atlmlb wasmlb 1/ 
gid 2017 06 14 balmlb chamlb 1/ 
gid 2017 06 14 bosmlb phimlb 1/ 
gid 2017 06 14 chnmlb nynmlb 1/ 
gid 2017 06 14 cinmlb sdnmlb 1/ 
gid 2017 06 14 colmlb pitmlb 1/ 
gid 2017 06 14 kcamlb sfnmlb 1/ 
gid 2017 06 14 lanmlb clemlb 1/ 
gid 2017 06 14 milmlb slnmlb 1/ 
gid 2017 06 14 nyamlb anamlb 1/ 
gid 2017 06 14 oakmlb miamlb 1/ 
gid 2017 06 14 seamlb minmlb 1/ 

id 2017 06 14 tbamlb tormlb 1/ 

»。 gid 2017 06 14 texmlb houmlb 1/ 

。 gridjson 

。 grid.xml 

。 grid ce.ison 


Index of /components/game/mlb/year_2017/month_06/day_14 


QQ 人 广 














图 9-1: 2017 年 6 月 14 日 进行 的 比赛 




















在 上 述 页 面 中 ， 每 个 链接 指向 一 场 比赛 。 链 接 以 字母 gid 开头 ， 后 跟 年 、 月 、 日 以 及 主队 


和 客队 代码 。 点 击 某 个 链接 ， 跳 转 后 的 页 面包 含 一 个 文件 列表 ， 其 中 有 一 个 名 为 boxscore. 


json 的 文件 。 

我 们 的 应 用 程序 将 完成 以 下 任务 。 

(D 访问 提供 指定 日 期 范围 内 各 场 比赛 信息 的 网 站 ; 

(2) 确定 每 个 页 面 的 比赛 链接 ， 

(3) 下 载 每 场 比赛 的 boxscore.json 文件 ; 

(4) 将 boxscore.json 文件 转换 为 相应 的 Java 对 象 ; 

(5) 将 下 载 结果 保存 到 本 地 文件 ， 

(6) 计算 每 场 比 赛 的 得 分 ; 

(7) 检索 总 分 最 高 的 比赛 ， 

(8) 打印 所 有 比赛 的 得 分 ， 以 及 出 现 最 高 得 分 的 比赛 及 其 得 分 。 


可 以 将 大 部 分 任务 安排 为 并 发 执行 ， 不 少 任务 都 能 以 并 行 方式 运行 。 








受 篇 幅 所 限 ， 无 法 将 完整 的 程序 代码 复制 到 书 中 ， 不 过 读者 可 以 从 GitHub 下 载 “。 本 范例 





将 重点 讨论 并 行 流 和 CompLetabLeFuture 的 应 用 。 




















比赛 的 统计 数据 称 为 技术 统计 。 
注 17: 链接 如 下 : https://github.com/kousen/cfboxscores。 





注 16: 只 要 了 解 以 下 内 容 ， 理 解 本 例 就 不 会 存在 障碍 : 在 棒球 比赛 中 ， 两 队 轮 流 攻守 ， 得 分 较 高 的 队 胜出 ， 
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第 一 个 难点 在 于 如 何 找 出 给 定 范 围 内 每 个 比赛 日 的 比赛 链接 。 如 例 9-28 所 示 ，GamePage 
LinksSupplier 类 实现 了 Supplier 接口 ， 其 作用 是 生成 一 个 表示 比赛 链接 的 字符 串 列 表 。 


例 9-28 获取 某 个 日 期 范围 内 的 比赛 链接 
public class GamePageLinksSuppLier implements Supplier<List<String>> { 
private static final String BASE = 
"http://gd2.mlb.com/components/game/mlb/"; 
private LocalDate startDate; 
private int days; 


public GamePageLinksSupplier(LocalDate startDate, int days) { 
this.startDate = startDate; 
this.days = days; 

} 


public List<String> getGamePageLinks(LocalDate localDate) { 
// 使 用 Jsoup 库 解析 HTML 网 页 ， 并 提取 以 "gid" 开 头 的 链接 











} 

@Override 

public List<String> get() { 0 

return Stream.iterate(startDate, d -> d.plusDays(1)) 

.limit(days) 
.map(this: :getGamepPageLinks) 
.flatMap(list -> list.isEmpty() ? Stream.empty() : list.stream()) 
.Collect(Collectors. toList()); 

} 


} 
@ Supplier<List<String>> 所 需 的 方法 


get 方法 使 用 Stream.iterate 方法 对 某 个 范围 内 的 日 期 进行 迭代 : 从 给 定 日 期 开始 ， 逐 天 
递增 直至 上 限 。 


Java 9 为 LocalDate 类 引入 了 datesUntil 方法 ， 它 将 生成 Stream<LocalDate>。 
相关 讨论 请 参见 范例 10.7。 














每 个 LocalDate 都 成 为 getGamePageLinks 方法 的 参数 ， 它 使 用 Jsoup 库 解 析 HTML 页 面 
并 查找 所 有 以 gid 开头 的 链接 ， 然 后 以 字符 串 的 形式 返回 这 些 链接 。 

接 下 来 ， 程 序 通 过 实现 Function 接口 的 BoxscoreRetriever 类 来 访问 每 个 比赛 链接 中 的 
boxscore.json 文件 ， 如 例 9-29 所 示 。 


例 9-29 在 比赛 链接 列表 中 检索 技术 统计 列表 
public class BoxscoreRetriever implements Function<List<String>, List<Result>> { 
private static final String BASE = 
"http://gd2.mlb.com/components/game/mlb/"; 








private OkHttpClient client = new OkHttpClient(); 
private Gson gson = new Gson(); 
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@SuppressWarnings("ConstantConditions") 
public Optional<Result> gamePattern2ResuLt(String pattern) { 
// 省 略 代码 


String boxscoreUrl = BASE + dateUrL + pattern + "boxscore.json"; 





// 设置 0kHttp 库 以 创建 网 络 调用 
try { 
// 获取 响应 
if (!response.isSuccessful()) { 
System.out.println("Box score not found for " + boxscoreUrl); 
return Optional.empty(); 0 





return Optional.ofNullable( 
gson.fromJson(response.body().charStream(), Result.class)); @ 
} catch (IOException e) { 
e.printStackTrace(); 
return Optional.empty(); 0 


} 


@Override 
public List<Result> apply(List<String> strings) { 
return strings.parallelStream() 
.map(this: :gamePattern2Result) 
.filter(Optional::ispresent) 
.map(Optional: :get) 
.Collect(Collectors. toList()); 


} 
@ 如 果 由 于 降雨 或 其 他 因素 而 未 能 找到 技术 统计 信息 ， 则 返回 空 0ptional 
@ 利用 Gson 库 将 JSON 转换 为 Result 
BoxscoreRetriever 类 需要 使 用 OkHttp 库 和 Gson 库 以 下 载 JSON 格式 的 技术 统计 信息 ， 并 
将 其 转换 为 Result 类 型 的 对 象 。 由 于 BoxscoreRetriever 类 实现 了 Function 接口 ， 可 以 
实现 apply 方法 ， 从 而 将 字符 串 列 表 转 换 为 结果 列表 。 如 果 给 定 的 比赛 由 于 降雨 而 取消 ， 
或 因为 某 些 原因 导致 网 络 连 接 中 断 ， 则 可 能 找 不 到 该 场 比 赛 的 技术 统计 。 这 种 情况 下 ， 
gamePattern2Result 方法 将 返回 一 个 为 空 的 0ptionaL<ResuLt>。 
apply 方法 读 取 各 场 比赛 的 链接 ， 将 它们 转换 为 相应 的 opttonaL<ResuLt>。 接 下 来 ，appty 
方法 对 流 进 行 筛选 ， 仅 传递 非 空 的 0ptional 实例 ， 然 后 在 这 些 0ptionat 实例 上 调用 get 
方法 ， 最 后 将 它们 收集 到 结果 列表 。 





























Java9 为 Ooptional 类 引入 了 strean 方法 ， 它 可 以 将 fiLter(OptionaL: :isPresent) 
和 map(OptionatL: :get) 简化 为 flatMap(0ptional::stream)。 相 关 讨 论 请 参见 
范例 10.6。 








检索 到 技术 统计 信息 后 可 以 将 其 保存 为 本 地 文件 ， 如 例 9-30 所 示 。 
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例 9-30 ”将 每 场 比赛 的 技术 统计 信息 保存 为 文件 
private void saveResultList(List<Result> results) { 
results.parallelStream().forEach(this::saveResultTorile); 


} 


public void saveResultToFile(Result result) { 


// 根据 比赛 日 期 和 队 名 确定 文件 名 


try { 
File file = new File(dir + "/" + fileName); 
FiLLes.write(fiLLe.toPath().toAbsoLutePath( ) ， 0 


gson.toJson(result).getBytes()); 
} catch (IOException e) { 
e.printStackTrace(); 
} 
} 


@ 创建 或 覆盖 文件 ， 然 后 将 其 关闭 

如 果 文 件 不 存在 ，FitLes.write 方法 (使 用 默认 参数 ) 将 创建 一 个 新 文件 ， 否 则 覆盖 原 有 
文件 。 创 建 或 覆盖 文件 后 将 其 关闭 。 

程序 还 使 用 其 他 两 种 后 期 处 理 方 法 : getMaxScore 用 于 确定 某 场 给 定 比赛 的 最 高 总 分 ， 而 
getMaxGame 将 返回 出 现 最 高 分 的 那 场 比赛 。 两 种 方法 的 应 用 如 例 9-31 所 示 。 

例 9-31 获取 最 高 总 分 以 及 出 现 最 高 分 的 比赛 


private int getTotalScore(Result result) { 


// 两 队 得 分 之 和 



































} 


public OptionalInt getMaxScore(List<Result> results) { 
return results.stream() 
.mapToInt(this: :getTotalScore) 
.max(); 


} 


public Optional<Result> getMaxGame(List<Result> results) { 
return results.stream() 
.max(Comparator .comparingInt(this::getTotalScore)); 


} 


最 后 ， 通 过 CompletableFuture 将 前 面 讨论 的 所 有 方法 与 类 合并 在 一 起 。 主 程序 代码 如 
例 9-32 所 示 。 


例 9-32 主 程序 代码 
public void printGames(LocalDate startDate, int days) { 
CompletableFuture<List<Result>> future = 
CompletableFuture. supplyAsync( 
new GamePageLinksSupplier(startDate, days)) 
.thenApply(new BoxscoreRetriever()); 0 


CompletableFuture<Void> futureWrite = 
future.thenAcceptAsync(this::saveResultList) (2) 
.exceptionally(ex -> { 





System.err.printLn(ex.getMessage()); 
return null; 


}); 


CompletableFuture<OptionalInt> futureMaxScore = 

future. thenApplyAsync(this: :getMaxScore); 
CompletableFuture<Optional<Result>> futureMaxGame = 

future. thenApplyAsync(this: :getMaxGame); 
CompletableFuture<String> futureMax = 

futureMaxScore.thenCombineAsync(futureMaxGame, © 

(score, result) -> 
String.format("Highest score: %d, Max Game: %s" 


2 


score.orELse(0)，resuLt.orELse(nuLL) ) ) ; 


CompletableFuture.allOof(futureWrite, futureMax).join(); @ 


future.join().forEach(System.out::println); 
System.out.println(futureMax.join()); 


} 


@ 检索 技术 统计 信息 的 协调 任务 

@ 保存 为 文件 ， 如 果 出 现 问 题 则 异常 完成 

@ 合并 最 高 总 分 与 出 现 最 高 分 的 比赛 这 两 个 任务 
@ 完成 所 有 任务 

可 以 看 到 ， 程 序 创建 了 多 个 CompletableFuture 实例 。 第 一 个 CompletableFuture 实例 使 用 


GamePageLinksSupplier 类 检索 指定 日 期 内 所 有 比赛 的 页 


















































类 将 这 些 链 接 转换 为 结果 。 第 二 个 CompletableFuture 实例 设置 将 结果 写 入 磁盘 ， 


问题 则 异常 完成 。 两 个 后 期 处 到 


























及 HH 


上 时 现 最 高 分 的 那 场 比赛 , “而 aLLOf 方法 用 于 完成 所 有 任务 。 最 后 , 程序 打印 相应 的 结果 。 





而 链接 ， 然 后 通过 BoxscoreRetriever 
如 果 出 现 
方法 getMaxScore 和 getMaxGame 分 别 用 于 查找 最 高 总 分 以 











注意 thenApplyAsync 方法 的 应 用 。 该 方法 并 非 必需 ， 但 能 使 任务 以 异步 方式 运行 。 


如 果 需 要 检索 2017 年 5 月 5 日 到 5 月 7 日 三 天 的 技术 统计 信息 ， 请 使 用 以 下 语句 : 


GamePageParser parser = new GamePageParser(); 
parser .printGames(LocalDate.of(2017, Month.MAY, 5), 3); 


输出 结果 如 下 : 


Box score not found for Los Angeles at San Diego on May 5, 2017 
May 5, 2017: Arizona Diamondbacks 6, Colorado Rockies 3 

May 5, 2017: Boston Red Sox 3, Minnesota Twins 4 

May 5, 2017: Chicago White Sox 2, Baltimore Orioles 4 

// 更 多 数据 
May 7, 2017: Toronto BLue Jays 2, Tampa Bay Rays 1 

May 7, 2017: Washington Nationals 5, Philadelphia Phillies 6 





Highest score: 23, Max Game: May 7, 2017: Boston Red Sox 17, Minnesota Twins 6 





注 1 














8: 这 两 项 操作 显然 可 以 一 起 完成 ， 程 序 将 二 者 分 开 是 为 了 





展示 thenCombine 的 应 用 。 
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希望 本 范例 能 对 读者 有 所 启发， 通过 综合 运用 本 书 介 绍 的 各 种 知识 ， 包 括 Future 任务 
(使 用 ComptLetabLeFuture)、 国 数 式 接口 (如 Supplier 和 Function)、 类 (如 Optional、 
Streanm 与 LocalDate) 以 及 方法 (如 map、filter 与 flatMap)， 掌 握 如 何 解 决 复杂 而 有 趣 
的 问题 。 





另 见 
有 关 多 个 CompletableFuture 之 间 的 协调 请 参见 范例 9.6。 





第 10 章 


Java 9 新 特性 





写作 本 书 时 (2017 年 6 月 )，Java SDK 9 已 达到 功能 完成 (Feature Complete) 状态 ,但 尚未 
发 布 。 在 众多 新 特性 中 ， 外 界 最 为 关注 的 当 属 Jigsaw 项 目 (Project Jigsaw)， 它 是 Java 9 
引入 的 一 种 模块 化 (modularization) 机 制 。 


这 一 章 的 范例 将 讨论 Java 9 的 各 种 新 特性 ， 包 括 接 口中 的 私有 方法 以 及 创建 不 可 变 集合 所 
用 的 工厂 方法 ， 并 介绍 Stream、Collectors 与 Optional 新 增 的 各 种 方法 。 所 有 范例 均 在 
Java SE 9 Early Access build 174 下 测试 通过 。 

另 一 方面 ， 本 章 不 讨论 以 下 新 特性 : 

。 JShell 交互 式 控制 台 

。 改进 的 try-with-resources 代码 块 

。 钻石 运算 符 (diamond operator) 的 轻松 语法 

。 新 增 的 弃 用 警告 

。 用 于 实现 反应 式 流 (Reactive Streams) 的 Flow API 

。 用 于 实现 栈 遍 历 的 Stack-Walking API 

。 改进 的 Process API 

之 所 以 不 讨论 这 些 特性 ， 是 因为 它们 要 么 用 得 不 多 (如 钻石 运算 符 、 改 进 的 try-with- 
resources 代码 块 与 弃 用 警告 )， 要 么 较为 专业 (如 Stack-Walking API 和 改进 的 Process 
API) 。 而 文档 和 教程 对 JShell 的 描述 已 很 详细 ， 本 书 不 再 更 述 。 

此 外 ， 虽然 反应 式 流 的 引入 令 人 眼前 一 亮 ， 但 开源 社区 已 有 Reactive Streams、RxJava 等 
类 似 的 API 存在 。 对 于 社区 将 以 何 种 方式 支持 新 的 Java 9 API， 静 观 其 变 或 许 更 为 稳妥 。 





















































注 1: Java SE 9 已 于 2017 年 9 月 21 日 正式 发 布 。 截 至 2018 年 3 月 1 日 ， 最 新 版 本 为 9.0.4。 一 一 译 者 注 
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这 一 章 的 范例 有 望 涵盖 最 常见 的 用 例 ， 若 非 如 此 ， 本 书 下 一 版 将 增加 更 多 用 例 。* 

此 外 ， 这 一 章 的 范例 与 其 他 章节 略 有 不 同 。 本 书 以 用 例 驱 动 的 形式 编写 和 组 织 内 容 ， 每 个 
范例 致力 于 解决 一 个 特定 类 型 的 问题 。 而 这 一 章 的 部 分 范例 只 是 对 Java 9 引入 的 新 特性 进 
行 概 述 ， 不 涉及 具体 类 型 的 问题 。 


10.1 Jigsaw 中 的 模块 


问题 
用 户 希 望 访 问 Java 标准 库 中 的 模块 ， 并 将 自己 的 代码 封装 为 模块 。 


方案 
学 习 Jigsaw 模块 的 基础 知识 ， 以 及 如 何 使 用 经 过 模块 化 处 理 的 JDK。 然 后 等 待 Java 9 正式 
发 布 ， 再 决定 是 否 进 行 升级 。 


讨论 
JSR 376 即 Java 平台 模块 系统 (Java Platform Module System，JPMS ) ， 它 堪 称 Java 9 最 大 
也 是 最 富有 争议 的 变革 。 对 Java 进行 模块 化 处 理 的 工作 已 开展 近 10 年 *， 并 取得 了 不 同 程 
度 的 成 功 ，JPMS 就 是 这 些 成 果 的 集中 体现 。 

模块 系统 致力 于 提供 “ 强 有 力 ” 的 封装 ， 虽 然 这 对 维护 有 利 ， 但 其 副作用 也 不 容 小 靓 。 对 
一 门 有 20 多 年 历史 且 注 重 保持 向 后 兼容 性 的 语言 来 说 ， 这 种 根本 性 的 调整 绝 非 易 事 。 


例如 ， 模 块 的 概念 改变 了 public 和 private 的 性 质 。 如 果 模 块 没有 导出 特定 的 包 ， 就 无 法 
访问 包 中 的 类 (即便 被 声明 为 public)。 与 之 类 似 ， 如 果菜 个 类 不 在 导出 的 包 中 ， 就 不 能 
通过 反射 来 访问 类 中 的 非 公 共 成 员 。 这 将 影响 到 基于 反射 的 库 和 框架 (包括 流行 的 Spring 
和 Hibernate)， 以 及 JVM 上 几乎 所 有 的 非 Java 语言 。 作 为 对 各 方 的 让 步 ，Java 开发 团队 
建议 在 Java 9 中 上 默认 允许 使 用 命令 行 标 志 --itllegal-access=permit， 但 在 今后 的 版 本 中 了 予 
以 禁用 。” 

写作 本 书 时 (2017 年 6 月 )， 将 JPMS 规范 纳入 Java 9 的 提案 已 被 否决 过 一 次 ， 但 JSR 376 
专家 组 正在 对 规范 进行 修改 ， 以 便 为 再 次 投票 做 准备 。 此 外 ，Java 9 的 发 布 日 期 被 推迟 到 
2017 年 9 月 下 旬 。” 
















































































注 2: 那 时 候 ，Jigsaw 的 细节 应 该 已 经 很 完善 了 一 一 但 愿 如 此 。 

注 3: Jigsaw 项 目 于 2008 年 启动 。 

注 4: 相关 信息 参见 “Proposal: Allow illegal reflective access by default in JDK 9”。 

注 5: 在 2017 年 6 月 13 日 到 6 月 26 日 进行 的 第 二 次 投票 中 ，JPMS 规范 获得 了 一 致 通过 (一 票 弃权 )。 

注 6: Java 9 原 定 于 2016 年 9 月 22 日 发 布 ， 但 经 历 了 两 次 重大 推迟 (2017 年 3 月 、2017 年 7 月)， 主 要 原 
因 在 于 各 方 对 模块 化 的 争议 较 大 。 一 一 译 者 注 
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尽管 如 此 ，Java 9 可 能 会 包括 Jigsaw 的 部 分 内 容 ， 其 基本 功能 也 已 确定 。 本 范例 旨 在 介绍 
这 些 功能 ， 方 便 读 者 了 解 必要 的 背景 信息 ， 以 便 在 JPMS 规范 获 批 后 做 好 应 用 准备 。 


首先 需要 指出 的 是 ， 读 者 不 必 急 着 将 自己 的 代码 模块 化 。 虽 然 Java 库 已 被 模块 化 ， 其 他 依 
赖 库 也 正在 进行 模块 化 处 理 ， 但 读者 不 妨 等 到 系统 稳定 后 再 对 代码 进行 操作 。 


模块 

除了 所 谓 的 未 命名 模块 (unnamed module) ，Java 9 定义 的 模块 都 有 一 个 名 称 ， 并 通过 名 为 
module-info.java 的 文件 定义 相关 的 依赖 和 需要 导出 的 包 。 此 外 ， 在 模块 可 交付 的 JAR 文件 
中 包括 一 个 经 过 编译 的 module-info.class 文件 。 


module-info.java 文件 称 为 模块 描述 符 (module descriptor) ， 它 以 关键 字 module 开头 ， 通 过 
关键 字 requires 和 exports 描述 模块 的 功能 。 接 下 来 ， 我 们 以 一 个 简单 的 “Hello, World!” 
程序 为 例 来 讨论 ， 程 序 将 使 用 两 个 模块 以 及 JVM。 

两 个 示例 模块 为 com.oreilly.suppliers 和 com.kousenit.clients。 前 者 提供 表示 姓名 的 字 
符 串 流 ， 后 者 将 每 个 姓名 以 及 欢迎 消息 打印 到 控制 台 。 











“ 反 向 URL”(reversed URL) 模式 是 目前 推荐 使 用 的 模块 命名 约定 。 


对 于 Supplier 模块 ，NamesSupplier 类 的 源 代码 如 例 10-1 所 示 。 
例 10-1 提供 姓名 流 


package com.oreilly.suppliers; 
// 导入 


public class NamesSupplier implements Supplier<Stream<String>> { 
private Path namesPath = Paths.get("server/src/main/resources/names.txt"); 


@Override 
public Stream<String> get() { 
try { 
return FiLes.Lines(namesPath ) ; 
} catch (IOException e) { 
e.printStackTrace(); 
return null; 


} 
} 
请 注意 ，Supplier 模块 保存 在 IntelliJ 模块 中 。 不 过 ，Intelli] IDEA 同样 使 用 “模块 ”一 
词 ， 但 此 模块 非 彼 “ 模 块 "， 它 表示 “服务 器 ”(server)， 这 也 是 文本 文件 的 路 径 中 出 
现 “server” 的 原因 。 
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names.txt 文件 的 内 容 如 下 : 


Londo 
Vir 
G'Kar 
Na'Toth 
Delenn 
Lennier 
Kosh 


对 于 Client 模块 ，Main 类 的 源 代码 如 例 10-2 所 示 。 


例 10-2 打印 姓名 


package com.kousenit.clients; 





// 导入 


public class Main { 


public static void main(String[] args) throws IOException { 
NamesSupplier supplier = new NamesSupplier(); 


try (Stream<String> Lines = supplier.get()){ © 
Lines.forEach(Line -> System.out.printf("Hello, %s!%n", line)); 


} 


} 
@ try-with-resources 自动 关闭 流 





例 10-3 显示 了 定义 Supplier 模块 的 module-info.java 文件 。 


例 10-3 定义 Supplier 模块 
module com.oreilly.suppliers { 
exports com.oreilly.suppliers; 


} 
@ 模块 名 
@ 使 模块 可 供 其 他 模块 使 用 














例 10-4 显示 了 定义 Client 模块 的 module-info.java 文件 。 


例 10-4 定义 Client 模块 
module com.kousenit.clients { 
requires com.oreilly.suppliers; 


} 
@ 模块 名 
@ 请 求 Supplier 模块 





注 7: 是 时 候 在 本 书 中 使 用 《巴比伦 五 号 》 的 示例 了 一 一 想 














是 一 部 在 1994 年 到 1998 年 期 间 播 出 的 美 
名 均 为 剧 中 角色 。 一 一 译 者 注 ) 











0 
@ 


0 
@ 





下 








必 空 间 站 也 是 由 各 种 模块 构成 的 。(《 




















国 科 幻 上 





电视 连续 剧 ， 共 110 集 。names.txt 文人 





巴比伦 五 号 》 





8 现 的 姓 





执行 例 10-2 的 程序 ， 输 出 如 下 : 


Hello, Vir! 
Hello, G'Kar! 
Hello, Na'Toth! 
Hello, Delenn! 
Hello, Lennier! 
Hello, Kosh! 





定义 Supplier 模块 时 必须 使 用 exports 子 句 ， 以 便 NamesSupplier 类 对 Client 模块 可 见 。 
Client 模块 定义 中 的 requires 子 句 用 于 通知 程序 ，CLient 模块 需要 使 用 Supplier 模块 中 
的 类 。 


如 果 和 希望 在 Supplier 模块 中 记录 对 服务 器 的 访问 ， 一 种 方案 是 利用 java.util.logging 包 
定义 的 Logger 类 在 JVM 中 添加 一 个 日 志 记 录 器 ， 如 例 10-5 所 示 。 


例 10-5 为 supplier 模块 添加 日 志 记 录 
public class NamesSupplier implements Supplier<Stream<String>> { 
private Path namesPath = Paths.get("server/src/main/resources/names.txt"); 
private Logger Logger = Logger.getLogger(this.getClass().getNane()); © 





@Override 
public Stream<String> get() { 
Logger .info("Request for names on " + Instant.now()); © 
try { 
return Files.lines(namesPath); 
} catch (IOException e) { 
e.printStackTrace(); 
return null; 


} 
@ 创建 日 志 记 录 器 
@ 使 用 时 间 惟 记录 对 服务 器 的 访问 
不 过 ， 上 述 代码 无 法 编译 。 这 是 因为 经 过 模块 化 处 理 后 ，JVM 目前 默认 提供 的 唯一 模块 是 
java.base， 但 java.base 并 不 包括 java.util.logging 包 。 为 使 用 Logger 类 ， 需 要 更 新 定 
义 Supplier 模块 的 module-info.java 文件 ， 如 例 10-6 所 示 。 
例 10-6 定义 Supplier 模块 (更 新 后 的 module-info.java 文件 ) 


module com.oreilly.suppliers { 
requires java.logging; 0 
exports com.oreilly.suppliers; 









































} 
@ 除 java.base 模块 外 ， 从 JVM 请 求 java.1logging 模块 


JVM 中 的 每 个 模块 都 有 各 自 的 module-info.java 文件 。 以 java.logging 模块 为 例 ， 定 义 它 
的 module-info.java 文件 如 例 10-7 所 示 。 
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例 10-7 ” Logging API 的 module-info.java 文件 
module java.logging { 
exports java.util.logging; 
provides jdk.internal.logger .DefaultLoggerFinder with 
sun.util.logging.internal.LoggingProviderImpl; 


} 


上 述 module-info.java 文件 不 仅 导出 java.logging 模块 ， 当 客户 端 请 求 日 志 记 录 器 上 时， 还 
会 以 LoggingProviderImpl 类 的 形式 提供 SPI (服务 提供 者 接口 ) DefaultLoggerFinder 的 
内 部 实现 。 

















Jigsaw 还 提供 用 于 处 理 服务 定位 器 和 提供 者 的 机 制 ， 详 细 信 息 请 参考 文档 。 


希望 本 范例 能 对 读者 有 所 局 发 ， 了 解 模块 是 如 何 定义 与 应 用 的 。 


在 JPMS 规范 获 批 之 前 ，JSR 376 专家 组 还 将 解决 更 多 与 模块 有 关 的 问题 ， 不 少 问题 涉及 
遗留 代码 的 移植 。 例 如 ， 未 命名 模块 和 自动 模块 (automatic module) 的 代码 不 属于 任何 模 
块 ， 而 是 位 于 “模块 路 径 ”(module path) 以 及 由 现 有 遗留 JAR 文件 所 构成 的 模块 中 。 有 
关 JPMS 的 和 争议， 相当 一 部 分 在 于 如 何 处 理 这 些 问 题 。 














器 

另 见 

Jigsaw 的 开发 属于 OpenJDK 项 目的 一 部 分 ， 感 兴趣 的 读者 可 以 阅读 快速 指引 (“Project 
Jigsaw: Module System Quick-Start Guide”) 和 相关 文档 (“The State of the Module System ” ) 。 


10.2 接口 中 的 私有 方法 

问题 

用 户 希 望 将 私有 方法 添加 到 接口 中 ， 这 些 方法 可 以 被 接口 中 的 其 他 方法 调用 。 
方案 

Java 9 目前 支持 在 接口 方法 中 使 用 private 关键 字 。 

讨论 


从 Java 8 开始 ， 开 发 人 员 可 以 为 接口 编写 方法 实现 ， 并 将 它们 标记 为 default 或 static。 
接 下 来 ， 将 private 方法 添加 到 接口 是 顺理成章 的 事情 。 


私有 方法 使 用 关键 字 private， 且 必须 有 一 个 实现 。 与 类 中 的 私有 方法 相似 ， 无 法 重 写 接 
口中 的 私有 方法 。 更 重要 的 是 ， 私 有 方法 只 能 从 同一 个 源 文件 中 调用 。 
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例 10-8 虽然 略 显 刻 意 ， 但 仍 有 一 定 说 服 力 。 
例 10-8 接口 中 的 私有 方法 


import java.util.function.IntPpredicate; 
import java.util.stream.IntStream; 


public interface SumNumbers { 
default int addEvens(int... nums) { 


return add(n -> n% 2 == 0, Nums); 
} 
default int addOdds(int... nums) { 
return add(n -> n% 2 != 0, Nums); 
} 
private int add(IntPredicate predicate, int... nums) { 0 
return IntStream.of(nums) 
.filter(predicate) 
.Sum(); 
} 
} 
@ 私有 方法 


由 于 接口 中 的 默认 访问 是 公共 的 ，addEvens 和 add0dds 方法 都 属于 public， 它 们 传 入 整数 
的 可 变 参 数列 表 作为 参数 。 两 种 方法 的 default 实现 被 委托 给 add 方法 。 除 整数 的 可 变 参 
数列 表 外 ，add 方法 还 传人 IntPredicate 作为 参数 。 任 何 客户 端 都 无 法 访问 被 声明 为 私有 
方法 的 add 方法， 即便 通过 实现 SumNumbers 接口 的 类 也 是 如 此 。 

例 10-9 显示 了 私有 方法 在 接口 中 的 应 用 。 


例 10-9 测试 接口 中 的 私有 方法 


class PrivateDemo impLements SumNumbers {} © 














import org.junit.Test; 
import static org.junit.Assert.*; 


public class SumNumbersTest { 
private SumNumbers demo = new PrivateDemo(); 


@Test 
public void addEvens() throws Exception { 

assertEquaLs(2 + 4 + 6, demo.addEvens(1, 2, 3, 4, 5, 6)); © 
} 


@Test 
public void add0dds() throws Exception { 
assertEquals(1 + 3 + 5, demo.add0dds(1, 2, 3, 4, 5, 6)); 台 
} 
} 


@ 实现 SumNumbers 接口 的 类 
@ 调用 委托 给 私有 方法 的 公共 方法 
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由 于 只 能 实例 化 一 个 类 ， 程 序 创建 了 一 个 实现 SunNumbers 接口 的 空 类 。 这 个 名 为 PrivateDemo 


的 类 被 实例 化 ， 其 公共 接口 方法 可 以 被 调用 。 


10.3 创建 不 可 变 集合 





用 户 希望 在 Java 9 中 创建 不 可 变 列 表 、 和 集合 或 映射 。 
方案 
使 用 Java 9 新 增 的 静态 工厂 方法 List.of、Set.of 与 Map.of。 


讨论 


根据 Javadoc 的 描述 ， 可 以 使 用 Java 9 引入 的 各 种 List.of() 静态 工厂 方法 方便 地 创建 不 








可 变 列表 。 通 过 这 些 方法 创建 的 List 实例 具有 以 下 特征 。 





。 结构 上 是 不 可 变 的 (structurally immnutable) ， 即 无 法 执行 添加 、 删 除 或 替换 元 素 的 操作 ， 
且 调 用 任何 更 改 器 方法 (mutator method) 都 会 抛 出 UnsupportedOperationException。 
然而 ， 如 果 包 含 的 元 素 本 身 是 可 变 的 ， 则 可 能 导致 List 的 内 容 发 生变 化 。 

。 禁止 使 用 null 元 素 , 尝试 创建 包含 null 元 素 的 List 实例 将 抛 出 NullPointerException。 

。 如 果 所 有 元 素 是 可 序列 化 的 (serializable)， 则 List 实例 也 是 可 序列 化 的 。 




















。 尹 
。 根据 Serialized Form 页 面 的 规定 进行 序列 化 。 


例 10-10 列 出 了 List.of 方法 所 有 可 用 的 重 载 形式 。 
例 10-10 用 于 创建 不 可 变 列表 的 静态 工厂 方法 


es 




















static <E> List<E> of() 

static <E> List<E> of(E el1) 

static <E> List<E> of(E el1，E e2) 

static <E> List<E> of(E ei, E e2, E e3) 

static <E> List<E> of(E ei, E e2, E e3, E e4) 

static <E> List<E> of(E ei, E e2, E e3, E e4, E e5) 

static <E> List<E> of(E ei, E e2, E e3, E e4, E e5， 

static <E> List<E> of(E el1，E e2, E e3, E e4, E e5， 

static <E> List<E> of(E el1，E e2, E e3, E e4, E e5， 

static <E> List<E> of(E ei, E e2, E e3, E e4, E e5， 

static <E> List<E> of(E ei, E e2, E e3, E e4, E e5， 
E e10) 

static <E> List<E> of(E... elements) 





mmmm m 


e6) 
e6, 
e6 ， 
e6 ， 
e6 ， 


表 中 元 素 的 顺序 与 所 提供 参数 的 顺序 相同 ， 与 所 提供 数组 中 元 素 的 顺序 也 相同 。 


E e7) 

E e7, E e8) 

E e7, E e8, E e9) 
E e7, E e8, E e9, 


正如 Javadoc 指出 的 那样 ， 通 过 上 述 方法 创建 的 列表 在 结构 上 是 不 可 变 的 ， 因 此 无 法 
在 List 上 调用 任何 常规 的 更 改 器 方法 。 换言之 ,调用 add、addAll、clear、remove、 
removeALL、FrepLaceALL 以 及 set 都 会 抛 出 Unsupported0perationException。 例 10-11 显示 
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了 部 分 测试 用 例 。* 
例 10-11 不 可 变 列表 的 应 用 


QTest(expected = UnsupportedOperationException.class) 

public void showImmutabilityAdd() throws Exception { 
List<Integer> intList = List.of(1, 2, 3); 
intList.add(99); 

} 


QTest(expected = UnsupportedOperationException.class) 

public void showImmutabilityClear() throws Exception { 
List<Integer> intList = List.of(1, 2, 3); 
intList.clear(); 


} 


QTest(expected = UnsupportedOperationException.class) 

public void showImmutabilityRemove() throws Exception { 
List<Integer> intList = List.of(1, 2, 3); 
intList.remove(0); 


} 


QTest(expected = UnsupportedOperationException.class) 

public void showImmutabilityReplace() throws Exception { 
List<Integer> intList = List.of(1, 2, 3); 
intList.replaceAll(n -> -nN); 


} 


@Test(expected = UnsupportedOperationException.class) 

public void showImmutabilitySet() throws Exception { 
List<Integer> intList = List.of(1, 2, 3); 
intList.set(0, 99); 


} 
然而 ， 如 果 列 表 包 含 的 对 象 本 身 是 可 变 的 ， 那 么 列表 也 可 能 发 生变 化 。 为 说 明 这 个 问题 ， 
我 们 创建 一 个 名 为 HoLder 的 类 。 这 个 类 很 简单 ， 它 包含 一 个 可 变 值 x， 如 例 10-12 所 示 。 
例 10-12 包含 可 变 值 的 简单 类 


public class HoLder { 
private int x; 











public Holder(int x) { this.x = x; } 


public void setx(int x) { 
this.x = x; 


} 


public ;int getx() { 
return X; 


} 

















注 8: 完整 的 测试 用 例 请 参见 本 书 源 代码 。 
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如 果 创 建 一 个 HoLder 实例 的 不 可 变 列表 ， 由 于 Holder 包含 的 值 是 可 变 的 ， 列 表 也 会 发 生 
变化 ， 如 例 10-13 所 示 。 


例 10-13 修改 包装 的 整数 
@Test 
public void areWeImmutableOrArentWe() throws Exception { 
List<Holder> holders = List.of(new Holder(1), new Holder(2)); © 
assertEquals(1, holders.get(0).getX()); 





holders.get(0).setX(4); 2) 
assertEquals(4, holders.get(0).getX()); 
} 


@ Holder 实例 的 不 可 变 列表 
@ 修改 Holder 中 包含 的 值 


虽然 上 述 代 码 可 以 运行 且 不 违反 文档 规定 ， 但 有 悖 于 开发 所 应 遵循 的 最 佳 实践 。 换 言 之 ， 
如 果 计 划 使 用 不 可 变 列表 ， 应 尽量 在 列表 中 包含 不 可 变 对 象 。 


类 似 地 ， 根 据 Javadoc 的 描述 ， 可 以 使 用 各 种 Set .of() 方法 方便 地 创建 不 可 变 集合 。 通 过 
这 些 方法 创建 的 Set 实例 具有 以 下 特征 。 


。 创建 时 (creation time) 拒绝 重复 元 素 ， 传 递 给 静态 工厂 方法 的 重复 元 素 会 导致 
ILLegaLArgumentException。 

。 未 指定 集合 元 素 的 迭代 顺序 ， 因 此 它 可 能 会 发 生变 化 。 

所 有 Set.of() 方法 的 签名 与 对 应 的 List.of() 方法 相同 ， 只 不 过 返回 的 是 Set<E>。 

Map.of() 方法 同样 如 此 ， 但 其 签名 传人 交替 的 键 和 值 作 为 参数 ， 如 例 10-14 所 示 。 

例 10-14 用 于 创建 不 可 变 映射 的 静态 工厂 方法 


static <K,V> Map<K,V> of() 

static <K,V> Map<K,V> of(K ki1, 

static <K,V> Map<K,V> of(K ki1, 

static <K,V> Map<K,V> of(K ki1, 

static <K,V> Map<K,V> of(K ki1, 
K k4, V v4) 

static <K,V> Map<K,V> of(K k1i, V v1i, K k2, V v2, K k3, V v3, 
K k4, V v4, K k5, V v5) 



































v1) 

vi, K k2, V v2) 

v1i, K k2, V v2, K k3, V v3) 
v1i, K k2, V v2, K k3, V v3, 


static <K,V> Map<K,V> of(K k1, V vi, K k2, V v2, K k3, V v3, 
K k4, V v4, K k5, V v5, K k6, V v6) 

static <K,V> Map<K,V> of(K k1, V vi, K k2, V v2, K k3, V v3, 
K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7) 

static <K,V> Map<K,V> of(K k1, V vi, K k2, V v2, K k3, V v3, 
K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8) 

static <K,V> Map<K,V> of(K k1, V vi, K k2, V v2, K k3, V v3, 
K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, 


K k9, V v9) 
static <K,V> Map<K,V> of(K k1i, V v1i, K k2, V v2, K k3, V v3, 
K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, 
K k9, V v9, K k10, V v10) 
static <K,V> Map<K,V> ofEntries(Map.Entry<? extends K,? extends V>... entries) 








在 创建 包含 最 多 10 个 条 目的 映射 时 ， 虽 然 可 以 使 用 相应 的 Map.of() 方法 ( 交 赫 传 入 键 








和 值 )， 不 过 这 并 非 最 佳 方案 ， 因 此 Map 接口 还 定义 了 另外 两 种 静态 方法 ， 即 ofEntries 
和 entry: 
static <K,V> Map<K,V> ofEntries(Map.Entry<? extends K,? extends V>... entries) 
static <K,V> Map.Entry<K,V> entry(K k, V v) 








例 10-15 显示 了 如 何 利用 上 面 介绍 的 各 种 方法 创建 不 可 变 上 映射 。 
例 10-15 利用 各 种 方法 创建 不 可 变 映 射 


QTest 
public void immutableMapFromEntries() throws Exception { 


} 


Map<Stri 
Map. 
Map. 
Map. 
Map. 
Map. 


Set<Stri 











ng, String> jvmLanguages = Map.ofEntries( 0 
entry("Java", "http://www.oracle.com/technetwork/java/index.html"), 
entry("Groovy", "http://groovy-lang.org/"), 

entry("Scala", "http://www.scala-lang.org/"), 

entry("Clojure", "https://clojure.org/"), 

entry("Kotlin", "http://kotlinlang.org/")); 


ng> names = Set.of("Java", "Scala", "Groovy", "Clojure", "Kotlin"); 


List<String> urls = List.of("http://www.oracle.com/technetwork/java/index.html", 


"http://groovy-lang.org/", 
"http://www.scala-lang.org/", 
"https://clojure.org/", 
"http://kotlinlang.org/"); 


Set<String> keys = jvmLanguages.keySet(); 
Collection<String> values = jvmLanguages.values(); 


names.forEach(name -> assertTrue(keys.contains(name))); 
urls.forEach(url -> assertTrue(valuyes.contains(url))); 


Map<String, String> javaMap = Map.of("Java", © 


javaMap. 


"http://www.oracle.com/technetwork/java/index.html", 

"Groovy", 

"http://groovy-lang.org/", 

"Scala", 

"http://www.scala-lang.org/", 

"Clojure", 

"https://clojure.org/", 

"Kotlin", 

"http://kotlinlang.org/"); 

forEach((name, url) -> assertTrue( 

jvmLanguages .keySet().contains(name) && \ 
jvmLanguages .values().contains(uyrl))); 


@ 使 用 Map.ofEntries 方法 
@ 使 用 Map.of 方法 
可 以 看 到 ， 将 ofEntries 与 entry 方法 结合 在 一 起 使 用 有 助 于 简化 代码 。 








Java 9 新 特性 | 203 


另 见 
有 关 在 Java 8 以 及 更 早 版 本 中 创建 不 可 变 集合 的 讨论 请 参见 范例 4.8。 


10.4 新 增 的 Stream 方 法 


问题 
用 户 希 望 使 用 Java 9 为 Strean 接口 添加 的 新 特性 。 


方案 


使 用 Strean 接口 新 增 的 ofNullable、iterate、takeWhile 以 及 dropWhile 方法 。 


讨论 
Java 9 为 Stream 接口 引入 了 ofNuLLabLe、iterate、takeNhiLe、dropWhitLe 等 新 方法 ， 本 范 
例 将 讨论 它们 的 用 法 。 
1. ofNullable 方 法 
在 Java 8 中 ，of 方法 包括 两 种 形式 ， 一 种 传人 单个 值 ， 另 一 种 传人 可 变 参 数列 表 。 无 论 哪 
种 形式 ， 参 数 都 不 能 为 空 。 
而 在 Java 9 中 ， 新 的 ofNuLLable 方法 可 以 在 参数 不 为 空 时 返回 一 个 包装 值 的 单元 素 流 ， 为 
空 时 返回 一 个 空 流 。 例 10-16 的 用 例 显示 了 该 方法 的 应 用 。 
例 10-16 ofNullable 方法 的 应 用 

QTest 

public void ofNullable() throws Exception { 


Stream<String> stream = Stream.ofNullable("abc"); ©@ 
assertEquals(1, stream.count()); 


























stream = Stream.ofNullable(null); © 
assertEquals(0, stream.count()); 


} 
@ 单元 素 流 
@ 返回 Stream.empty() 
在 本 例 中 ，count 方法 返回 流 中 非 空 元 素 的 数量 ， 我 们 可 以 借 此 在 任何 参数 上 使 用 
ofNuLLable 方法 ， 而 无 须 首先 检查 参数 是 否 为 空 。 
2. 传 入 Predicate 的 iterate 方 法 
另 一 种 有 趣 的 方法 是 iterate。 在 Java 8 中 ，iterate 方法 的 签名 如 下 : 


static<T> Stream<T> iterate(final T seed, final UnaryOperator<T> f) 


创建 流 时 ， 从 初始 元 素 种 子 开始 ， 对 种 子 依次 应 用 一 元 运算 符 以 产生 后 续 元 素 。 由 于 生成 
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的 流 是 一 个 无 限 流 ， 通 常 需 要 采用 Limit 或 其 他 短路 操作 (short-circuiting operation， 如 
findFirst 或 findAny) 来 控制 返回 流 的 大 小 。 


在 Java 9 中 ，iterate 方法 新 增 了 一 种 重 载 形 式 ， 它 传人 Predicate 作为 第 二 个 参数 : 


static<T> Stream<T> iterate(T seed, Predicate<? super T> hasNext, 
UnaryOperator<T> next) 


创建 流 时 ， 从 初始 元 素 种 子 开始 ， 对 种 子 应 用 一 元 运算 符 ， 直 至 值 不 再 满足 谓词 hasNext。 
相关 应 用 如 例 10-17 所 示 。 
例 10-17 传 入 Predicate 的 iterate 方法 


























QTest 
public void iterate() throws Exception { 
List<BigDecimal> bigDecimals = 0 
Stream.iterate(BigDecimal.ZERO, bd -> bd.add(BigDecimal .ONE)) 
.limit(10) 


.collect(Collectors. toList()); 
assertEquals(10, bigDecimals.size()); 
bigDecimals = Stream.iterate(BigDecimal.ZERO0, ©@ 

bd -> bd.LongvaLue() < 10L, 

bd -> bd.add(BigDecimal .ONE)) 

.collect(Collectors. toList()); 


assertEquals(10, bigDecimals.size()); 


} 
@ 创建 BigDecimal 流 (Java 8 实现 ) 





@ 创建 BigDecimal 流 (Java 9 实现 ) 


第 一 个 流 使 用 iterate 方法 ， 并 通过 Limit 方法 控制 大 小 ， 这 是 Java 8 的 实现 方式 ， 第 二 
个 流传 入 Predicate 作为 第 二 个 参数 ， 看 起 来 更 像 是 传统 的 for 循环 。 

3. takeWhile 与 dropWhile 方 法 

Java 9 新 增 了 takeWhile 和 dropWhile 方法， 二 者 基于 谓词 获取 流 的 某 一 部 分 。 根 据 
Javadoc 的 描述 ， 对 于 有 序 流 ，takeWhile 方法 从 流 的 起 始 位 置 开 始 ， 返 回 “ 匹 配给 定 谓词 
的 元 素 的 最 长 前 级 ”。 


dropWhile 方法 的 作用 正好 相反 ， 在 丢弃 匹配 给 定 谓词 的 元 素 的 最 长 前 缀 后， 该 方法 将 返 
回流 的 其 余 元 素 。 


两 种 方法 在 有 序 流 上 的 应 用 如 例 10-18 所 示 。 
例 10-18 获取 与 丢弃 流 中 的 元 素 


QTest 
public void takeWhile() throws Exception { 
List<String> strings = Stream.of("this is a list of strings".split(" ")) 
.takeWhile(s -> !s.equals("of")) © 
.collect(Collectors. toList()); 
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List<String> correct = Arrays.asList("this", "is", "a", "list"); 
assertEquals(correct, strings); 


} 


@Test 
public void dropWhile() throws Exception { 
List<String> strings = Stream.of("this is a list of strings".split(" ")) 
.dropWhile(s -> !s.equals("of")) @ 
.Collect(Collectors. toList()); 
List<String> correct = Arrays.asList("of", "strings"); 
assertEquals(correct, strings); 


























} 
@ 当 不 再 满足 谓词 时 ， 返 回 谓词 之 前 的 元 素 
@ 当 不 再 满足 谓词 时 ， 返 回 谓词 之 后 的 元 素 























可 以 看 到 ， 两 种 方法 在 同一 个 位 置 将 流 拆 分 ， 不 过 takeWhile 返回 拆 分 位 置 之 前 的 元 素 ， 

而 dropWhile 返回 拆 分 位 置 之 后 的 元 素 。 

takeWhile 方法 的 最 大 优点 在 于 它 是 一 种 短路 操作 : 对 于 一 个 包含 大 量 排序 元 素 的 集合 
只 要 达到 所 设 定 的 条 件 ， 就 可 以 停止 求 值 。 


例如 ， 假设 存在 一 个 由 客户 订单 构成 的 集合 ， 集 合 中 的 元 素 以 降序 方式 排序 。 借 由 
takeWhile 方法 ， 我 们 可 以 只 "获取 高 于 某 个 国 值 的 订单 ， 而 不 必 人 篇 选 每 个 元 素 。 
例 10-19 模拟 了 这 种 情况 。 程 序 生 成 50 个 0 到 100 之 间 的 随机 整数 ， 对 它们 做 降序 排序 ， 
然后 仅 返 回 大 于 90 的 整数 。 
例 10-19 对 整数 流 应 用 takeWhile 方法 
Random random = new Random(); 
List<Integer> nums = randonm.ints(50, 0, 100) © 
.boxed() 
.sorted(Comparator .reverseOrder()) 


.takeWhile(n -> n > 70) 
.collect(Collectors. toList()); 


@ 生成 50 个 0 到 100 之 间 的 随机 整数 

@ 将 这 些 整数 装 箱 ， 以 便 采用 Comparator 排序 并 收集 

@ 将 流 拆 分 并 返回 大 于 90 的 整数 

改 用 dropwhile 方法 或 许 能 让 本 例 看 起 来 更 为 直观 〈 尽 管 效 率 未 必 会 提高 )， 如 例 10-20 所 示 。 
例 10-20 ”对 整数 流 应 用 dropwhile 方法 


Random random = new Random(); 
List<Integer> nums = random.ints(50, 0, 100) 












































.Sorted() 0 
.dropWhile(n -> n < 90) @ 
.boxed() 


.collect(Collectors.toList()); 





@ 将 流 拆 分 并 返回 大 于 90 的 整数 


类 似 takeWhile 和 dropWhile 这 样 的 方法 在 其 他 语言 中 已 存在 多 年 ，Java 9 将 二 者 正式 引 
入 Java。 


10.5 下游 收 集 器 : filtering 与 flatMapping 


问题 
用 户 希 望 将 元 素 作为 下 游 收集 器 (downstream collector) 的 一 部 分 进行 算 选 ， 或 将 集合 的 
集合 展 平 。 


方案 


使 用 Java 9 为 Collectors 类 新 增 的 filtering 和 flatMapping 方法 。 


讨论 

Java 8 为 Collectors 类 引入 了 groupingBy 操作 ， 用 于 根据 特定 的 属性 将 对 象 分 组 。 分 组 
操作 将 产生 一 个 “ 键 - 值 列表 ”映射 (Map<Kk，List<T>>)。Java 8 还 支持 使 用 下 游 收集 器 ， 
可 以 不 必 生 成 列表 ， 而 是 对 列表 进行 后 期 处 理 以 获取 其 大 小 ， 或 将 列表 映射 为 其 他 内 容 。 
Java 9 新 增 了 两 种 下 游 收 集 器 ， 它 们 是 filtering 和 flatMapping。 

1. filtering 方 法 

假设 存在 两 个 类 ， 一 个 类 是 Task， 该 类 包括 描述 预算 的 属性 以 及 承担 任务 的 开发 人 员 列 
表 ; 另 一 个 类 是 Developer ， 它 的 实例 用 于 描述 开发 人 员 。 两 个 类 如 例 10-21 所 示 。 


例 10-21 Task 和 DeveLoper 类 


public class Task { 
private String name; 
private long budget; 
private List<Developer> developers = new ArrayList<>(); 









































// 构造 国 数 、getter、setter 等 
} 


public class Developer { 
private String name; 


// 构造 国 数 、getter、setter 等 


首先 ， 我 们 根据 预算 对 任务 进行 分 组 。 例 10-22 显示 了 一 个 简单 的 groupingBy 操作 。 
例 10-22 根据 预算 对 任务 分 组 


DeveLoper venkat = new Developer("Venkat"); 
Developer daniel = new Developer("Daniel"); 
Developer brian = new Developer("Brian"); 
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DeveLoper matt = new Developer("Matt"); 
Developer nate = new Developer("Nate"); 
Developer craig = new Developer("Craig"); 
Developer ken = new Developer("Ken"); 


Task java = new Task("Java stuff", 100); 

Task aLtJvm = new Task("Groovy/Kotlin/Scala/Clojure", 50); 
Task javaScript = new Task("JavaScript (sorry)", 100); 
Task spring = new Task("Spring", 50); 

Task jpa = new Task("JPA/Hibernate", 20); 


java.addDevelopers(venkat, daniel, brian, ken); 
javaScript.addDevelopers(venkat, nate); 
spring.addDevelopers(craig, matt, nate, ken); 
altJvm.addDevelopers(venkat, daniel, ken); 


List<Task> tasks = Arrays.asList(java, altJvm, javaScript, spring, jpa); 


Map<Long, List<Task>> taskMap = tasks.stream() 
.collect(groupingBy(Task: :getBudget)); 


由 此 建立 了 预算 金额 与 分 配 该 预算 的 任务 列表 之 间 的 映射 ; 


50: [Groovy/Kotlin/Scala/Clojure, Spring] 
20: [JPA/Hibernate] 
100: [Java stuff, JavaScript (sorry)] 


如 果 只 希望 获取 预算 超过 某 个 国 值 的 任务 ， 可 以 添加 一 个 filter 操作 ， 如 例 10-23 所 示 。 
例 10-23 利用 filter 操作 进行 分 组 


taskMap = tasks.stream() 
.filter(task -> task.getBudget() >= THRESHOLD) 
.collect(groupingBy(Task: :getBudget)); 


如 果 国 值 为 50， 程 序 的 输出 如 下 : 


50: [Groovy/Kotlin/Scala/Clojure, Spring] 
100: [Java stuff, JavaScript (sorry)] 


可 以 看 到 ， 预 算 低 于 国 值 的 任务 不 会 出 现在 输出 映射 中 ， 不 过 仍然 有 办 法 显示 这 些 任务 : 
在 Java 9 中 ，Collectors 类 新 增 了 一 个 名 为 filtering 的 静态 方法 ， 它 与 filter 类 似 ， 只 
不 过 用 于 下 游 任务 列表 的 第 选 。filtering 方法 的 用 法 如 例 10-24 所 示 。 
例 10-24 利用 下 游 盘 选 器 进行 分 组 

taskMap = tasks.stream() 


.collect(groupingBy(Task::getBudget, 
filtering(task -> task.getBudget() >= 50, toList()))); 


此 时 ， 所 有 预算 金额 都 会 以 键 的 形式 显示 出 来 ， 但 预算 低 于 国 值 的 任务 不 会 出 现在 列表 值 中 : 


50: [Groovy/Kotlin/Scala/Clojure, Spring] 
20: [] 
100: [Java stuff, JavaScript (sorry)] 


因此 ，filtering 操作 是 一 种 下 游 收集 器 ， 可 以 对 分 组 操作 产生 的 列表 操作 。 



































IT 
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2. flatMapping 方 法 
那么 ， 如 何 获 取 承 担 每 项 任务 的 开发 人 员 列 表 呢 ?如 例 10-25 所 示 ， 借 由 基本 的 分 组 操作 ， 
可 以 根据 任务 名 对 任务 分 组 。 


例 10-25 根据 任务 名 分 组 


Map<String, List<Task>> tasksByName = tasks.stream() 
.collect(groupingBy(Task: :getNanme)); 


(格式 化 后 的 ) 输出 如 下 : 


Java stuff: [Java stuff] 
Groovy/Kotlin/Scala/Clojure: [Groovy/Kotlin/Scala/Clojurel] 
JavaScript (sorry): [JavaScript (sorry)] 

Spring: [Spring] 

JPA/Hibernate: [JPA/Hibernate] 


为 获取 与 任务 关联 的 开发 人 员 列 表 ， 我 们 使 用 下 游 收集 器 mapping， 如 例 10-26 所 示 。 
例 10-26 承担 每 项 任务 的 开发 人 员 列 表 


Map<String, Set<List<Developer>>> map = tasks.stream() 
.collect(groupingBy(Task: :getName, 
CoLLectors .mapping(Task: :getDevelopers, toSet()))); 


不 过 ， 返 回 类 型 是 Set<List<Developer>>， 而 我 们 需要 的 是 一 个 下 游 flatMap 操作 来 展 平 
集合 的 集合 。 为 此 ， 可 以 使 用 Collectors 类 新 增 的 flatMapping 方法 ， 如 例 10-27 所 示 。 


例 10-27 利用 flatMapping 方法 获取 一 组 开发 人 员 
Map<String, Set<Developer>> task2setdevs = tasks.stream() 
.collect(groupingBy(Task: :getName, 
Collectors.flatMapping(task -> task.getDevelopers().stream(), 
toSet()))); 


(格式 化 后 的 ) 输出 如 下 : 


Java stuff: [Daniel, Brian, Ken, Venkat] 
Groovy/Kotlin/Scala/Clojure: [Daniel, Ken, Venkat] 
JavaScript (sorry): [Nate, Venkat] 
Spring: [Craig, Ken, Matt, Nate] 
JPA/Hibernate: [] 






































Collectors.flatMapping 方法 类 似 于 Stream.flatMap 方法 。 需 要 注意 的 是 ，flatMapping 方 
法 的 第 一 个 参数 应 是 一 个 流 ， 它 可 以 为 空 ， 或 不 依赖 于 数据 源 。 


另 见 
有 关 下 游 收集 器 的 讨论 请 参见 范例 4.6， 有 关 flatMap 操作 的 讨论 请 参见 范例 3.11。 
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10.6 ”新 增 的 0ptional 方 法 


问题 
用 户 希 望 执行 以 下 操作 : 将 0ptional 映射 并 展 平 到 包含 元 素 的 流 中 ;从 几 种 可 能 的 条 人 
进行 选择 ， 当 元 素 存 在 时 进行 茶 种 操作 ， 否 则 返回 默认 值 。 


方案 

使 用 Java 9 为 Ooptional 类 新 增 的 stream、or 或 ifPresentorElse 方法。 

讨论 

Java 8 引入 了 0ptional 类 ， 用 于 告知 客户 端 返回 值 可 能 合法 为 nutL。 返 回 的 并 非 nutl， 而 
是 空 Optional。 对 可 能 返回 (或 不 返回 ) 值 的 方法 而 言 ，0ptional 是 一 种 不 错 的 包装 器 。 
1. stream 方 法 

例 10-28 显示 了 一 种 根据 ID 检索 客户 的 查找 器 方法 (finder method)。 

例 10-28 根据 ID 查找 客户 


public Optional<Customer> findById(int id) { 
return Optional.ofNullable(map.get(id)); 





中 


让 

















} 
findById 方法 假设 客户 包含 在 内 存 的 Map 中 。map.get 方法 在 键 存在 时 返回 一 个 值 ， 否 则 
返回 nuLL， 因 此 将 其 作为 Optional.ofNullable 方法 的 参数 时 ， 要 么 在 0ptional 中 包装 一 
个 非 空 值 ， 要 么 返回 一 个 空 0ptional。 




















由 于 0ptional.of 方法 在 参数 为 null 时 将 抛 出 异常 ， 采 用 optionaL.ofNuLLabtLe(arg) 
更 方便 ， 其 实现 为 arg != nuLL ? Optional.of(arg) : Optional.empty()。 








findById 方法 返回 的 是 0ptional<Customer>， 如 果 堂 试 返回 客户 集合 则 上 略 显 复杂 。 在 Java 8 
中 ， 不 难 写 出 如 例 10-29 所 示 的 代码 。 
例 10-29 在 0ptional 上 使 用 filter 和 map 方法 


public Collection<Customer> findAllById(Integer... ids) { 
return Arrays.stream(ids) 























.map(this: :findById) 0 
.filter(Optional::ispresent) ©@ 
.map(Optional: :get) © 


.Collect(Collectors. toList()); 


} 
@ 映射 到 Stream<0ptional<Customer>> 


@ 筛 掉 所 有 空 Optional 
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@ 调用 get 方法 以 映射 到 Stream<Customer> 


上 述 实现 并 不 难 ， 但 利用 Java 9 为 optional 类 新 增 的 strean 方法 ， 可 以 使 这 个 过 程 更 简 
单 。strean 方法 的 签名 如 下 : 


Stream<T> stream() 


如 果 值 存在 ，strean 方法 将 返回 一 个 顺序 的 单元 素 流 ， 流 中 仅 包 含 该 值 ， 如 果 值 不 存在 ， 
strean 方法 将 返回 一 个 空 流 。 借 由 strean 方法 ， 可 选 的 客户 流 可 以 直接 转换 为 客户 流 ， 
如 例 10-30 所 示 。 


例 10-30 使 用 传 入 0ptional.streanm 的 flatMap 方法 
public Collection<Customer> findAllById(Integer... ids) { 
return Arrays.stream(ids) 
.map(this: :findById) 0 
.flatMap(Optional: :stream) 8 
.collect(Collectors. toList()); 




















} 
@ 映射 到 Stream<0ptional<Customer>> 
@ 映射 并 展 平 为 Stream<Customer> 
使 用 strean 纯粹 是 为 了 方便 ， 但 它 不 失 为 一 种 有 用 的 方法 。 
2. or 方法 
orElse 方法 用 于 从 0ptional 中 提取 值 ， 它 传人 默认 值 作为 参数 ; 
Customer customer = findById(id).orELse(Customer.DEFAULT) 
也 可 以 使 用 传 入 Supplier 来 创建 默认 值 的 orELseGet 方法 ， 不 过 这 是 一 种 成 本 较 高 的 操作 : 
Customer customer = findById(id).orElseGet(() -> createDefauLtCustomer()) 
orElse 和 orELseGet 方法 均 返 回 Customer 实例 。 而 Java9 新 增 的 or 方法 可 以 在 给 定 
Supplier 时 返回 Optional<Customer>， 从 而 将 查找 客户 的 其 他 方式 链接 在 一 起 。 
or 方法 的 签名 如 下 : 
Optional<T> or(Supplier<? extends Optional<? extends T>> supplier) 
如 果 值 存在 ，or 方法 将 返回 描述 该 值 的 0ptional， 否 则 返回 由 Supplier 生成 的 0ptional。 
我 们 现在 可 以 通过 多 种 方式 查找 客户 ， 例 10-31 展示 了 or 方法 的 应 用 。 
例 10-31 改 用 or 方法 


public Optional<Customer> findById(int id) { 
return findByIdLocal(id) 
.or(() -> findByIdRemote(id)) 
.or(() -> Optional.of(Customer .DEFAULT)); 

















} 


程序 首先 在 本 地 缓存 中 搜索 客户 ， 再 访问 远程 服务 器 。 如 果 两 种 方式 都 未 能 找到 非 空 
Optional， 最 后 一 个 子 句 创 建 一 个 默认 值 ， 将 其 包装 在 0ptional 中 并 返回 。 
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3. ifPresent0rELse 方 法 
如 果 0ptional 不 为 空 ，ifpresent 方法 将 执行 Consumer 指定 的 操作 ， 如 例 10-32 所 示 。 
例 10-32 利用 ifpresent 方法 仅 打印 非 空 客户 


public void printCustomer(Integer id) { 
findByIdLocal(id).ifpresent(System.out::println); ©@ 


} 
public void printCustomers(Integer... ids) { 
Arrays.asList(ids) 
.forEach(this::printCustomer); 
} 


@ 仅 打 印 非 空 Optional 


虽然 ifPresent 方法 很 有 用 ， 不 过 如 果 返 回 的 Optional 为 空 ， 我 们 可 能 还 希望 执行 其 他 所 
作 。Java 9 新 增 的 ifPresent0rELse 方法 包括 两 个 参数 ， 在 eT 为 空 时 将 执行 
参数 Runnable 指定 的 操作 。 该 方法 的 签名 如 下 : 


void ifPresentOrELse(Consumer<? super T> action, Runnable emptyAction) 




















天 行 第 二 


使 用 ifPresentorElse 方法 时 ， 只 需 提 供 一 个 不 传人 任何 参数 并 返回 void 的 lambda 表达 











式 ， 如 例 10-33 所 示 。 
例 10-33 打印 客户 或 默认 消息 


public void printCustomer(Integer id) { 
findByIdLocal(id).ifpresentOrElse(System.out::println, 
() -> System.out.println("Customer with id=" + id + " not found")); 


} 
如 果 找 到 指定 的 客户 ， 程 序 将 打印 该 客户 ， 否 则 打印 默认 消息 


0ptional 类 新 增 的 这 些 方法 均 未 从 根本 上 改变 各 自 的 用 途 ， 但 它们 确实 为 开发 提供 了 更 大 





的 便利 。 


另 见 
有 关 Java 8 引入 的 0ptional 类 请 参见 第 6 章 。 


10.7 ”日 期 苑 围 


用 户 希 望 返回 两 个 给 定 端点 之 间 的 日 期 流 。 


使 用 Java 9 为 LocalDate 类 新 增 的 datesUntil 方法 。 








讨论 
较 之 java.util.Date、java.util.Calendar 以 及 java.sql.Timestamp 类 ，Java8 引入 的 


Date-Time API 是 一 种 巨大 改进 。 而 Java 9 新 增 的 datesUntil 方法 解决 了 Date-Time API 中 
一 个 令 人 头 疫 的 问题 难以 方便 地 创建 日 期 流 。 


在 Java 8 中 ,创建 日 期 流 最 简单 的 方式 是 以 初始 日 期 为 基准 ， 再 添加 一 个 偏 移 量 。 例 如 ， 
为 返回 相隔 一 周 的 两 个 给 定 端点 之 间 的 所 有 天 数 ， 我 们 可 能 会 写 出 如 例 10-34 所 示 的 代码 。 


例 10-34 返回 两 个 日 期 之 间 的 天 数 (存在 问题 ) 
public List<LocalDate> getDays_java8(LocalDate start, LocalDate end) { 
Period period = start.until(end); 
return IntStream.range(0, period.getDays()) ©@ 
.mapTo0bj(start:pLusDays) 
.collect(Collectors. toList()); 





























} 
@ 实 为 陷阱 ! 正确 实现 参见 例 10-35。 


程序 首先 计算 两 个 日 期 之 间 的 Period， 然 后 在 二 者 之 间 创 建 一 个 IntStream。 执 行程 序 ， 
观察 结 束 日 期 和 开始 日 期 相隔 一 周 时 的 情况 : 
LocalDate start = LocalDate.of(2017, Month.JUNE, 10); 


LocalDate end = LocalDate.of(2017, Month.JUNE, 17); 
System.out.println(dateRange.getDays_java8(start, end)); 











// [29017-06-10, 2017-06-11, 2017-06-12, 2017-06-13, 
// 2017-06-14, 2017-06-15, 2017-06-16] 


上 述 代 码 看 似 正确 ， 实 则 有 误 。 如 果 将 结束 日 期 改 为 与 开始 日 期 相隔 正好 一 个 月 ， 很 容易 
就 能 看 出 问题 所 在 : 
LocalDate start = LocalDate.of(2017, Month.JUNE, 10); 


LocalDate end = LocalDate.of(2017, Month.JULY, 10); 
System.out.println(dateRange.getDays_java8(start, end)); 


// [] 


可 以 看 到 ， 程 序 没有 返回 任何 值 。 原 因 在 于 period.getDays 方法 返回 的 只 是 两 个 天 数字 段 之 
间 的 天 数 ， 而 非 两 个 日 期 之 间 的 总 天 数 (getMonths、getYears 等 方法 同样 如 此 )。 如 上 所 示 ， 
由 于 开始 日 期 和 结束 日 期 的 天 数 相 同 ， 虽 然 月 份 不 同 ， 结 果 仍 然 是 一 个 大 小 为 0 的 范围 。 


为 解决 这 个 问题 ， 应 采用 实现 TemporaLuUnit 接口 的 ChronoUnit 枚 举 ， 它 定义 了 DAYS、 
MONTHS 等 多 个 枚 举 常量 。Java 8 的 正确 实现 如 例 10-35 所 示 。 


例 10-35 返回 两 个 日 期 之 间 的 天 数 〈 正 确实 现 ) 
public List<LocalDate> getDays_java8(LocalDate start, LocalDate end) { 
Period period = start.until(end); 
return LongStream.range(0, ChronoUnit.DAYS.between(start, end)) © 
.mapTo0bj(start:pLusDays) 
.collect(Collectors. toList()); 
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@ 正确 无 误 
我 们 也 可 以 使 用 iterate 方法 ， 但 需要 了 解 两 个 日 期 之 间 的 天 数 ， 如 例 10-36 所 示 。 


例 10-36 LocalLDate 的 达 代 


public List<LocalDate> getDaysByIterate(LocalDate start, int days) { 
return Stream.iterate(start, date -> date.plusDays(1)) 
.limit(days) 
.Collect(Collectors. toList()); 


} 
好 在 Java 9 引入 的 新 方法 使 问题 得 以 简化 。LocalDate 类 新 增 了 一 种 名 为 datesUntil 的 方 
法 ， 其 重 载 形 式 传人 Period 作为 参数 。datesUntil 方法 的 签名 如 下 : 


Stream<LocalDate> datesUntil(LocalDate endExclusive) 
Stream<LocalDate> datesUntil(LocalDate endExclusive, Period step) 


不 传 入 Period 的 datesUntil 方法 实际 上 相当 于 将 日 期 增 量 设置 为 一 天 ， 即 datesUntil 
(endExclusive) 等 效 于 datesUntil(endExclusive, Period.ofDays(1))。 


采用 datesuntil 方法 返回 两 个 日 期 之 间 的 天 数 要 简单 得 多 ， 如 例 10-37 所 示 。 
例 10-37 返回 两 个 日 期 之 间 的 天 数 (Java 9 实现 ) 


public List<LocalDate> getDays_java9(LocalDate start, LocalDate end) { 
return start.datesUntil(end) 0 
.Collect(Collectors. toList()); 











} 
public List<LocalDate> getMonths_java9(LocalDate start, LocalDate end) { 
return start.datesUntil(end, Period.ofMonths(1)) @ 
.Collect(Collectors. toList()); 


} 
@ 相当 于 Period.ofDays(1) 
@ 日 期 增 量 为 一 个 月 
我 们 可 以 使 用 所 有 常规 的 流 处 理 技 术 对 datesUntil 方法 产生 的 Streanm 操作 。 





另 见 
有 关 在 Java 8 中 计算 两 个 日 期 之 间 的 天 数 ， 请 参见 范例 8.8。 








附录 A 
沁 型 与 Java 8 





AT 月 景 

Java 1.5 引入 了 入 型 (generics) 的 概念 。 遗 憾 的 是 ， 大 部 分 Java 开发 人 员 对 于 泛 型 的 了 解 
仅 停留 在 完成 工作 所 需 的 层面 上 。 随 着 Java 8 的 兴起 ，Javadoc 中 出 现 了 不 少 使 用 泛 型 的 
方法 签名 。 以 java.util.Map.Entry 接口 的 comparingByKey 方法 为 例 : 


static <K extends Comparable<? super K>,V> Comparator<Map.Entry<K,V>> 
comparingByKey() 





以 及 java.util.Comparator 接口 的 comparing 方法 : 


static <T,U extends Comparable<? super U>> Comparator<T> comparing( 
Function<? super T,? extends U> keyExtractor) 


甚至 java.util.stream.Collectors 类 的 groupingBy 方法 : 


static <T,K,D,A,M extends Map<K, D>> Collector<T,?,M> groupingBy( 
Function<? super T,? extends K> classifier, Supplier<M> mapFactory, 
Collector<? super T,A,D> downstream) 


显然 ， 对 泛 型 仅 有 最 低 限度 的 了 解 是 远 远 不 够 的 。 本 附录 则 在 分 析 这 些 签名 的 结构 ， 以 帮 
助 读者 在 开发 中 更 有 效 地 应 用 API。 


A.2 ”众所周知 的 事实 


在 使 用 List 或 Set 这 样 的 集合 时 ， 可 以 将 元 素 的 类 名 置 于 尖 括 号 中 ， 以 声明 所 包含 元 素 的 
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List<String> strings = new ArrayList<String>(); 

Set<Employee> employees = new HashSet<Employee>(); 
通过 在 之 后 的 示例 代码 中 引入 钻石 运算 符 (diamond operator) ，Java 7 能 在 一 
定 程度 上 简化 语法 。 由 于 等 号 左 侧 的 引用 已 经 声明 了 集合 以 及 所 包含 的 类 型 
(如 List<string> 或 List<Integer>)， 等 号 右 侧 的 实例 化 无 须 再 次 声明 。 我 
们 可 以 将 其 简写 为 new ArrayList<>()， 而 不 必 将 类 型 置 于 尖 括 号 中 。 























声明 集合 的 数据 类 型 可 以 实现 两 个 目的 : 


。 能 避免 不 慎 将 错误 的 类 型 置 于 集合 中 
。 无 须 再 将 检索 到 的 值 强制 转换 为 合适 的 类 型 


如 例 A-1 所 示 ， 在 声明 strings 变量 之 后 ， 就 只 能 向 集合 添加 String 实例 ， 并 在 检索 到 某 
项 时 自动 获得 一 个 String。 


例 A-1 简单 的 泛 型 示例 
List<String> strings = new ArrayList<>(); 
strings.add("Hello"); 
strings.add("World"); 
// strings.add(new Date()); 0 
// Integer i = strings.get(0); © 





























for (String s : strings) { @ 
System.out.printf("%s has Length %d%n", s, s.length()); 
} 
@ 无 法 编译 


@ for-each 循环 了 解 所 包含 的 数据 类 型 为 String 
对 插入 过 程 应 用 类 型 安全 (type safety) 很 方便 ， 但 开发 人 员 很 少 会 犯 这 个 错误 。 不 过 ， 如 
果 不 必 首 先 强 制 转换 就 可 以 处 理 检 索 类 型 ， 能 极 大 简化 代码 。! 


另 一 个 众所周知 的 事实 是 ， 无 法 为 泛 型 集合 添加 基本 数据 类 型 (primitive type)。 换 言 之 ， 
目前 尚 无 法 定义 List<int> 或 List<double>。? 幸运 的 是 ，Java 1.5 在 引入 泛 型 的 同时 也 引 
入 了 自动 装 箱 和 拆 箱 。 因 此 ， 如 果 和 希望 在 泛 型 类 型 (generic type) 中 储存 基本 数据 类 型 ， 
可 以 通过 包装 类 (wrapper class) 声明 该 类 型 ， 如 例 A-2 所 示 。 


例 A-2 在 泛 型 集合 中 使 用 基本 数据 类 型 
List<Integer> ints = new ArrayList<>(); 
ints.add(3); ints.add(1); ints.add(4); 
ints.add(1); ints.add(9); ints.add(2); 
System.out.println(ints); 














for (int i : ints) { 
System.out.println(i); 


} 











注 1: 在 整个 职业 生涯 中 ， 我 从 未 不 慎 将 错误 的 类 型 添加 到 列表 中 。 不 过 即便 只 是 考虑 到 糟糕 的 语法 ， 去 掉 
强制 转换 过 程 也 是 值得 的 。 
注 2: Java 10 (Valhalla 项 目 ) 已 提出 将 基本 数据 类 型 添加 到 集合 中 。 
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可 以 看 到 ，Java 在 插入 时 将 int 值 包装 在 Integer 实例 中 ， 并 在 检索 时 从 Integer 实例 中 
取出 这 些 值 。 尽 管 装 箱 和 拆 箱 的 效率 有 待 商检， 但 代码 确实 很 容易 编写 。 


此 外 ，Java 开发 人 员 耳 熟 能 详 的 一 点 是 ， 如 果 一 个 类 使 用 了 泛 型 ， 那 么 类 型 本 身 采 用 尖 括 
号 中 的 大 写字 母 表示 。 例 如 ，Javadoc 对 java.util.List 接口 的 描述 如 下 : 


public interface List<E> extends Collection<E> 


其 中 E 是 类 型 参数 (type parameter)， 且 接口 中 的 方法 使 用 相同 的 类 型 参数 。 例 A-3 显示 
了 List 接口 声明 的 部 分 方法 。 
例 A-3 List 接口 声明 的 部 分 方法 
boolean add(E e) 
boolean addALL(CoLLection<? extends E> c) 
void clear() 
boolean contains(Object o) 


boolean containsAll(Collection<?> c) 
E get(int index) 


类 型 参数 E 用 作 参 数 或 返回 类 型 
@ 有 界 通配符 
@ 与 类 型 本 身 无 关 的 方法 
@ 未 知 类 型 


可 以 看 到 ， 某 些 方法 使 用 声明 的 泛 型 类 型 E 作为 参数 或 返回 类 型 ， 某 些 方法 (特别 是 
clear 和 contains) 完全 不 使 用 类 型 ， 还 有 部 分 方法 使 用 问号 作为 通配符 。 


请 注意 ， 在 非 泛 型 类 中 声明 泛 型 方法 是 合法 的 。 这 种 情况 下 ， 泛 型 参数 被 声明 为 方法 签名 
的 一 部 分 。 以 工具 类 java.util.Collections 为 例 ， 它 定义 了 以 下 静态 方法 : 

static <T> List<T> emptyList() 

static <K,V> Map<K,V> emptyMap() 

static <T> boolean addAll(Collection<? super T> c, T... elements) 


static <T extends Object & Comparable<? super T>> 
T min(Collection<? extends T> coll) 


如 上 所 示 ，emptyList、addAll、min 这 三 种 方法 声明 了 泛 型 参数 T。emptyList 方法 通过 T 
来 指定 List 中 包含 的 类 型 ， 而 emptyMap 方法 在 泛 型 映射 中 使 用 K 和 VvV 来 表示 键 的 类 与 值 
的 类 。 


addAll 方法 声明 了 泛 型 类 型 T， 并 使 用 CoLLection<? super T> c 作 为 方法 的 第 一 个 参数 ， 
T 类 型 的 可 变 参 数列 表 作 为 第 二 个 参数 。? super T 是 一 种 有 界 通配符 (bounded wildcard ) ， 
稍 后 将 对 此 做 讨论 。 


从 min 方法 可 以 看 出 泛 型 类 型 是 如 何 提供 安全 性 的 ， 但 其 签名 结构 或 许 不 那么 一 目 了 然 。 
后 面 将 详细 讨论 该 方法 的 签名 ， 目 前 不 妨 这 样 理解 : T 是 有 界 的 ， 它 既是 0bject 的 子 类 ， 
又 实现 了 Comparable 接口 ， 其 中 comparable 定义 为 T 或 T 的 任何 父 类 。min 方法 的 参数 与 
T 或 T 的 任何 子 类 的 Collection 有 关 。 
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最 后 ， 通 配 符 将 众所周知 的 语法 以 我 们 不 那么 熟悉 的 形式 表现 出 来 。 例 如 ， 某 些 语 法 看 似 
继承 ， 但 实际 上 根本 不 是 。 


A.3 容易 忽略 的 事实 


许多 开发 人 员 或 许 惊 讶 于 ArrayList<String> 和 ArrayList<0bject> 并 无 实质 性 的 关联 。 如 
例 A-4 所 示 ， 可 以 将 0bject 的 子 类 添加 到 Object 集合 中 。 


例 A-4 List<0bject> 的 应 用 
List<Object> objects = new ArrayList<0bject>(); 
objects.add("Hello"); 
objects .add(LocalDate.now()); 
objects .add(3); 
System.out.println(objects); 


很 好 ! 由 于 String 是 0bject 的 子 类 ， 可 以 将 String 引用 赋 给 0bject 引用 。 读 者 可 能 认 
为 ， 在 声明 字符 串 列表 之 后 就 能 为 其 添加 对 象 ， 但 实际 情况 并 非 如 此 ， 如 例 A-5 所 示 。 
例 A-5 List<string> 与 对 象 一 起 使 用 


List<String> strings = new ArrayList<>(); 











String s = "abc"; 
Object o = s; 0 
// strings.add(o); (2) 


// List<0bject> more0bjects = strings; © 
// moreObjects.add(new Date()); 
// String s = moreObjects.get(0); [49 
@ 合法 
@ 不 合法 
@ 同样 不 合法 ， 但 假设 其 合法 
@ 损坏 的 集合 


由 于 String 是 0bject 的 子 类 ， 我 们 可 以 将 String 引用 赋 给 object 引用 ， 但 无 法 将 0bject 
引用 添加 到 List<String>。 这 似乎 有 些 奇怪 ， 原 因 在 于 List<String> 并 非 List<0bject> 的 
子 类 。 在 声明 类 型 时 ， 可 以 添加 的 唯一 实例 就 是 所 声明 的 类 型 ， 使 用 子 类 或 超 类 实例 均 不 
合法 。 换 言 之 ， 参 数 化 类 型 (parameterized type) 具有 不 变性 (invariance ) 。 


在 本 例 中 ， 从 注释 掉 的 语句 不 难看 出 为 何 List<string> 不 是 List<0bject> 的 子 类 。 假 设 可 
以 将 List<string> 赋 给 List<0bject>， 那 么 通过 对 象 引 用 列表 就 能 将 非 字 符 捉 的 内 容 添 加 
到 列表 中 。 这 样 一 来 ， 采 用 字符 串 列 表 的 原始 引用 检索 时 会 导致 强制 转换 异常 ， 编 译 器 将 
无 法 判断 转换 是 否 有 效 。 

不 过 ， 如 果 定 义 了 一 个 数字 列表 ， 应 该 就 可 以 为 列表 添加 整数 、 浮 点 数 与 双 精 度 浮 点 数 。 
为 此 ， 我 们 需要 在 类 型 边界 (type bound) 中 使 用 通配符 。 
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A.4 通配符 与 PECS 


通配符 是 一 种 使 用 问号 (?) 的 类 型 参数 ， 可 能 存在 〈 也 可 能 不 存在 ) 上 界 或 下 界 。 


A.4.1 无 界 通配符 


没有 边界 的 类 型 参数 很 有 用 ， 不 过 也 存在 一 定局 限 性 。 如 例 A-6 所 示 ， 对 一 个 声明 为 无 界 
类 型 的 List 而 言 ， 可 以 读 取 ， 但 无 法 写 入。 


例 A-6 使 用 无 界 通配符 的 List 
List<?> stuff = new ArrayList<>(); 
// stuff.add("abc"); 0 
// stuff.add(new Object()); 
// stuff.add(3); 
int numELements = stuff.size(); @ 


@ 不 允许 进行 添加 操作 

@ numELements 为 0 

由 于 无 法 传 入 任何 内 容 ， 上 述 代码 的 意义 不 大 。 不 过 ， 无 界 List 的 一 种 用 途 在 于 ， 所 有 传 
入 List<?> 作为 参数 的 方法 都 会 在 调用 时 接受 任何 列表 ， 如 例 A-7 所 示 。 

例 A-7 无 界 List 作为 方法 参数 


private static void printList(List<?> list) { 
System.out.println(list); 


} 

















public static void main(String[] args) { 
// 创建 列表 ints、strings 与 stuff 
printList(ints); 
printList(strings); 
printList(stuff); 

} 


读者 或 许 还 记得 List<E> 接口 声明 的 containsAll 方法 ( 例 A-3) : 


boolean containsAll(Collection<?> c) 


只 有 当前 列表 包含 指定 集合 的 所 有 元 素 时 ，contaiinsAll 方法 才 返 回 true。 由 于 方法 参数 
使 用 的 是 无 界 通 配 符 ， 实 现 仅 限于 以 下 两 类 方法 : 

。 Collection 接口 定义 的 、 不 需要 包含 类 型 的 方法 

。 0bject 类 定义 的 方法 

对 于 containsAll 方法 ， 上 述 条 件 完全 符合 。 引 用 实现 中 的 默认 实现 (AbstractCoLLection 
类 ) 通过 iterator 方法 遍历 参数 ， 并 调用 contatns 方法 检查 其 中 的 所 有 元 素 是 否 也 在 原 
始 列 表 中 。iterator 和 contaiins 方法 定义 在 Collection 接口 中 ， 而 equals 方法 定义 在 
0bject 类 中 。contains 实现 委托 给 0bject 类 的 equals 和 hashCode 方法 ， 它 们 可 能 已 经 在 
包含 的 类 型 中 被 重 写 。 就 containsAll 方法 而 言 ， 它 需要 的 所 有 方法 都 是 可 用 的 ， 因 此 无 
界 通配符 不 会 对 该 方法 的 使 用 造成 影响 。 


问号 是 设置 类 型 边界 的 利器 ， 其 用 法 相当 多 样 化 。 
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A.4.2 上 界 通配符 


上 界 通配符 (upper bounded wildcard) 使 用 关键 字 extends 来 设置 超 类 限制 。 例 A-8 定义 
了 一 个 支持 int、long、double 甚至 BigDecimal 实例 的 数字 列表 。 





即便 采用 接口 (而 不 是 类 ) 作为 上 界 ， 也 可 以 使 用 关键 字 extends， 如 


List<? extends ComparabLe>。 





例 A-8 具有 上 界 的 List 


List<? extends Number> numbers = new ArrayList<>(); 


// numbers.add(3); 
// numbers.add(3.14159); 
// numbers.add(new BigDecimal("3")); 


@ 仍然 无 法 添加 值 


上 述 代码 看 似 不 错 ， 不 过 虽然 可 以 使 用 上 界 通 配 符 定义 列表 ， 但 仍然 无 法 为 列表 添加 值 。 
原因 在 于 检索 值 时 ， 编 译 器 并 不 清楚 列表 的 类 型 ， 只 知道 它 继承 了 Number。 


尽管 如 此 ， 我 们 可 以 定义 一 个 传人 List<? extends Number> 的 方法 参数 ， 然 后 通过 不 同 的 
列表 类 型 调用 方法 ， 如 例 A-9 所 示 。 


例 A-9 上 界 的 应 用 
private static double sumList(List<? extends Number> list) { 
return list.stream() 
.mapToDouble(Number: :doubleValue) 
.Sum(); 











} 


public static void main(String[] args) { 
List<Integer> ints = Arrays.asList(1, 2, 3, 4, 5); 
List<Double> doubles = Arrays.asList(1.0, 2.0, 3.0, 4.0, 5.0); 
List<BigDecimal> bigDecimals = Arrays.asList( 
new BigDecimal("1.0"), 
new BigDecimal("2.0"), 
new BigDecimal("3.0"), 
new BigDecimal("4.0"), 
new BigDecimal("5.0") 


); 


System.out.printf("ints sum is %s%n", sumList(ints)); 
System.out.printf("doubles sum is %s%n", sumList(doubles)); 
System.out.printf("big decimals sum is %s%n", sumList(bigDecimals)); 


} 


可 以 看 到 ， 使 用 相应 的 double 值 对 BigDecimal 实例 求 和 ， 会 抵消 首先 使 用 BigDecimal 所 带 
来 的 好 处 ， 但 只 有 基本 类 型 流 IntStream、LongStrean 与 DoubLeStream 包括 sum 方 法。 不 
过 这 也 说 明 ， 可 以 使 用 Number 的 任何 子 类 型 (subtype) 的 列表 来 调用 方法 。 由 于 Number 
定义 了 doubleValue 方法 ， 代 码 成 功 编译 并 运行 。 
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从 具有 上 界 的 列表 中 访问 某 个 元 素 时 ， 结 果 肯 定 可 以 被 赋 给 上 界 类 型 的 引用 ， 如 例 A-10 
所 示 。 


例 A-10 从 上 界 引 用 中 提取 值 


private static double sumList(List<? extends Number> list) { 
Number num = list.get(0); 


// 其 余 代码 与 例 A-9 相 同 

















调用 方法 时 ， 列 表 元 素 要 么 是 Number， 要 么 是 它 的 某 个 子 类 ， 因 此 Number 引用 总 是 正确 的 。 


A.4.3 下 界 通配符 


下 界 通配符 (lower bounded wildcard) 表示 类 的 任何 父 类 均 满 足 条 件 ， 关 键 字 super 和 通 
配 符 用 于 指定 下 界 。 以 List<? super Number> 为 例 ， 引 用 既 可 以 代表 List<Number>， 也 可 
以 代表 List<0bject>。 


我 们 通过 上 界 指定 变量 必须 符合 的 类 型 ， 以 便 方法 实现 能 正常 工作 。 对 数字 求 和 时 ， 需 要 
确保 变量 有 一 个 定义 在 Number 中 的 doubleValue 方法 。 通 过 直接 或 重 写 的 形式 ，Number 的 
所 有 子 类 也 会 包含 doubleValue 方法 ， 这 就 是 将 输入 类 型 指定 为 List<? extends Number> 
的 原因 。 
而 在 下 界 通 配 符 中 ， 我 们 从 列表 中 取出 项 目 ， 并 添加 到 不 同 的 集合 。 目 标 集 合 既 可 以 是 
List<Number>， 也 可 以 是 List<0bject>， 因 为 单个 0bject 引用 可 以 被 赋 给 一 个 Number 。 
接 下 来 ,我们 将 讨论 一 个 经 常 被 引用 的 示例 。 尽 管 它 并 不 符合 真正 的 Java 8 习惯 用 法 ( 稍 
后 将 解释 原因 )， 但 的 确 阐释 了 下 界 通配符 的 概念 。 
如 例 A-11 所 示 ，numsUpTo 方法 传人 两 个 参数 ， 一 个 是 整数 ， 另 一 个 是 列表 。 采 用 所 有 数 
字 填 充 列 表 ， 直 至 达到 第 一 个 参数 指定 的 数字 。 
例 A-11 numsupTo 方法 用 于 填充 给 定 列 表 

public void numsUpTo(Integer num, List<? super Integer> output) { 


IntStream.rangeClosed(1, num) 
.forEach(output: :add); 















































} 


numsUpTo 方法 之 所 以 不 符合 Java 8 的 习惯 用 法 ， 是 因为 它 使 用 提供 的 列表 作为 输出 变 
量 。 这 实际 上 会 带 来 副作用 ， 因 此 不 鼓励 使 用 。 尽 管 如 此 ， 通 过 将 第 二 个 参数 的 类 型 设 
置 为 List<? super Integer>， 提 供 的 列表 就 可 以 是 List<Integer>、List<Number> 甚至 
List<0bject> 类 型 ， 如 例 A-12 所 示 。 


例 A-12 numsUpTo 方法 的 应 用 
ArrayList<Integer> integerList = new ArrayList<>(); 
ArrayList<Number> numberList = new ArrayList<>(); 
ArrayList<0bject> objectList = new ArrayList<>(); 











numsUpTo(5, integerList); 
numsUpTo(5, numberList); 
numsUpTo(5, objectList); 
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所 有 返回 的 列表 均 包含 数字 1 到 5$。 使 用 下 界 通配符 意味 着 列表 将 用 于 存储 整数 ， 但 我 们 
可 以 在 任何 超 类 型 (supertype) 的 列表 中 使 用 引用 。 


在 上 界 列表 中 ， 我 们 从 列表 中 提取 并 使 用 值 ， 在 下 界 列表 中 ， 我 们 为 列表 提供 值 。 二 者 的 
综合 应 用 构成 了 所 谓 的 PECS 原则 。 


A.4.4 PECS 原 则 


PECS 是 “Producer Extends, Consumer Super” 的 缩写 ， 这 是 Joshua Bloch 在 Efjfective Java 
一 书 ”中 引入 的 一 个 略 显 奇 怪 的 术语 , 但 有 助 于 理解 泛 型 的 用 法 。 换 言 之 , 参数 化 类 型 代表 
生产 者 (producer) 则 使 用 extends， 代 表 消 费 者 (consumer) 则 使 用 super。 如 果 参 数 同 
时 代表 生产 者 和 消费 者 则 无 须 使 用 通配符 ， 因 为 满足 这 两 项 要 求 的 唯一 类 型 就 是 显 式 类 型 
(explicit type) 自身 。 

可 以 将 PECS 原则 归纳 如 下 : 


。 仅 从 数据 结构 获取 值 时 ， 使 用 extends; 

。 仪 向 数据 结构 写 入 值 时 ， 使 用 super; 

。 如 果 需 要 同时 获取 和 写 入 值 ， 使 用 显 式 类 型 。 

对 于 本 节 讨 论 的 某 些 概念 ， 均 有 描述 这 些 概念 的 正式 术语 ， 它 们 经 常 在 Scala 这 样 的 语言 
中 使 用 。 
术语 协 变 (covariance) 表示 可 以 使 用 比 原始 指定 的 派生 类 型 更 大 的 类 型 。 在 Java 中 ， 由 
于 String[] 是 0bject[] 的 子 类 型 ， 数 组 是 协 变 的 ;除非 使 用 关键 字 extends 和 通配符 ， 否 
则 集合 不 是 协 变 的 。 
术语 逆 变 (contravariance) 表示 可 以 使 用 比 原始 指定 的 派生 类 型 更 小 的 类 型 。 在 Java 中 ， 
通过 关键 字 super 和 通配符 引入 逆 变 。 

术语 不 变性 (invariance) 表示 只 能 使 用 原始 指定 的 类 型 。 除 非 使 用 extends 或 super， 否 
则 Java 中 的 所 有 参数 化 类 型 都 具有 不 变性 。 换 言 之 ， 如 果 某 个 方法 要 求 List<Employee>， 
就 必须 提供 List<Employee>， 而 不 能 提供 List<0bject> 或 List<Salaried>’。 

PECS 是 对 形式 规则 (formal rule) 的 一 种 重 述 ， 即 类 型 构造 函数 在 输入 类 型 中 是 逆 变 的 ， 
在 输出 类 型 中 是 协 变 的 。 某 些 情况 下 ， 也 可 以 将 PECS 原则 表述 为 “ 读 取 时 使 用 extends， 


写 入 时 使 用 super” (be liberal in what you accept and conservative in what you produce ) 。 


A.4.5 ”多 重 边 界 


在 讨论 Java 8 API 中 的 示例 之 前 ， 我 们 先 来 介绍 多 重 边界 (multiple bound)。 类 型 参数 可 
以 有 多 重 边界 ， 边 界 之 间 通 过 “&” 符 号 隔 开 : 































































































注 3: 公认 的 经 典 Java 教程 ， 总 结 了 Java 程序 设计 中 大 量 极 具 实 用 价值 的 规则 ， 这 些 规则 涵盖 了 开发 中 可 

能 遇 到 的 各 种 问题 。 一 一 译 者 注 
注 4: 协 变 、 道 变 与 不 变性 的 定义 如 下 。 如 果 蕊 和 了 表示 类 型 , < 表示 子 类 型 关系 , ft?) 表示 类 型 转换 , 那么 : 
当 瑟 和 了 时 ，HB < 1 成立 ， 则 称 1?) 具有 协 变 性 ， 当 对 < 了 时 ,KD < 9%) 成立， 则 称 f?) 具有 
逆 变 性 ， 如 果 上 述 两 种 关系 均 不 成 立 ， 则 称 ft?) 具有 不 变性 。 一 一 译 者 注 
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T extends Runnable & AutoCloseable 


接口 边界 的 数量 并 无 限制 ， 但 只 能 有 一 个 类 边界 。 如 果 采 用 某 个 类 作为 边界 ， 它 必须 在 所 
有 边界 中 居于 首位 。 


A.5 Java 8 API 示 例 
接 下 来 ， 我 们 将 讨论 Java 8 引入 的 一 些 新 方法 。 





A.5.1 Stream.max 方 法 
在 java.util.stream.Strean 接口 中 ，max 方法 的 签名 如 下 : 


Optional<T> max(Comparator<? super T> comparator) 


注意 Comparator 中 使 用 的 下 界 通 配 符 。 通 过 应 用 所 提供 的 Comparator ，max 方法 将 返回 流 
中 最 大 的 元 素 。 由 于 流 在 为 空 时 可 能 没有 返回 值 ，max 方法 的 返回 类 型 为 optional<T>。 如 
果 找 到 最 大 值 ，max 方法 将 其 包装 在 0ptional， 否 则 返回 空 Optional。 
为 简单 起 见 ， 考 虑 例 A-13 显示 的 Employee POJO。 
例 A-13 简单 的 Employee POJO 

public class EmpLoyee { 


private int id; 
private String name; 





























public Employee(int id, String name) { 
this.id = id; 
this.name = name; 


} 
// 其 他 方法 














} 


例 A-14 创建 了 一 个 员工 集合 并 转换 为 Stream， 然 后 通过 max 方法 查找 具有 最 大 id 和 最 大 
name ( 按 字母 顺序 排序 ”) 的 员工 。 实 现 采 用 匿名 内 部 类 来 强调 Comparator 可 以 是 Employee 
或 0bject 类 型 。 


例 A-14 查找 最 大 的 Employee 
List<Employee> employees = Arrays.asList( 
new Employee(1, "Seth Curry"), 
new Employee(2, "Kevin Durant"), 
new Employee(3, "Draymond Green"), 
new Employee(4, "Klay Thompson")); 














Employee maxId = employees.stream() 
.max(new Comparator<Employee>() { 0 
@Override 























注 5: 严格 来 说 是 按 字典 序 (lexicographical order) 排序 ， 即 大 写字 母 位 于 小 写字 有 母 之 前 。 
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public int compare(Employee e1，EmpLoyee e2) { 
return e1.getId() - e2.getId(); 


} 
}).orELse(EmpLoyee.DEFAULT_EMPLOYEE ) ; 


EmpLoyee maxName = employees.stream() 
.max(new Comparator<Object>() { © 
@Override 
public int compare(Object o1, Object o2) { 
return o1.toString().compareTo(o2.toString()); 
} 
}).orELse(EmpLoyee.DEFAULT_EMPLOYEE ) ; 


System.out.printLn(maxId); © 
System.out.printLn(maxName); @ 





@ Comparator<Employee> 的 匿名 内 部 类 实现 
@ Comparator<0bject> 的 匿名 内 部 类 实现 
@ Klay Thompson (最 大 ID 为 4) 

@ Seth Curry (最 大 姓名 以 字母 S$ 开头 ) 


我 们 可 以 利用 Employee 类 中 的 方法 编写 Comparator， 不 过 仅 使 用 0bject 类 定义 的 方 
法 (如 toString) 同样 可 行 。 由 于 max 方法 的 定义 中 使 用 了 通配符 super (Comparator<? 
super T> comparator))，Comparator 既 可 以 是 Employee， 也 可 以 是 0bject。 

然而 ， 没 有 人 会 这 样 编写 代码 。 符 合 Java 8 习惯 用 法 的 实现 如 例 A-15 所 示 。 

例 A-15 查找 最 大 的 Employee (Java 8 习惯 用 法 ) 


import static java.util.Comparator.comparing; 
import static java.util.Comparator .comparingInt; 











// 创建 员工 列表 





Employee maxId = employees.stream() 
.max(comparingInt(Employee: :getId)) 
.orElse(Employee.DEFAULT_EMPLOYEE); 


Employee maxName = employees.stream() 
.max(comparing(Object::toString)) 
.orElse(Employee.DEFAULT_EMPLOYEE); 


System.out.println(maxId); 
System.out.println(maxName); 


上 述 代码 显然 更 为 简洁 ， 但 它 不 像 匿 名 内 部 类 那样 强调 有 界 通配符 。 





A.5.2 ” Stream.map 方 法 
Strean 接口 还 定义 了 一 个 名 为 map 的 方法 ， 它 传人 Function， 包 括 两 个 参数 ， 均 使 用 通配符 : 


<R> Stream<R> map(Function<? super T,? extends R> mapper) 
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map 方法 对 流 中 的 每 个 元 素 (T 类 型 ) 应 用 mapper 国 数 ， 将 其 转换 为 R 类 型 "的 一 个 实例 。 
因此 ，map 方法 的 返回 类 型 为 Stream<R>。 


由 于 Stream 被 定义 为 具有 类 型 参数 T 的 泛 型 类 (generic class) ，map 方法 不 必 在 签名 中 
再 定义 变量 T， 但 需要 使 用 另 一 个 类 型 参数 R， 以 便 在 返回 类 型 之 前 出 现在 签名 中 。 如 果 
Strean 不 是 泛 型 类 ，map 方法 将 声明 两 个 参数 T 和 R。 


java.util.function.Function 接口 定义 了 两 个 类 型 参数 ， 第 一 个 (输入 参数 ) 是 从 Stream 
消费 的 类 型 ， 第 二 个 (输出 参数 ) 是 函数 产生 的 对 象 类 型 。 通 配 符 意味 着 在 指定 参数 时 ， 
输入 参数 必须 与 Strean 的 类 型 相同 或 更 高 ， 而 输出 类 型 可 以 是 返回 流 类 型 的 任何 子 类 型 。 


从 PECS 原则 的 角度 来 看 ，Function 接口 的 定义 或 许 令 人 困惑 ， 因 为 类 型 是 
反 向 的 。 不 过 只 要 记 住 Function<T,R> 消费 T 并 产生 R， 就 能 理解 为 何 super 
后 跟 T， 而 extends 后 跟 R。 

















map 方法 的 应 用 如 例 A-16 所 示 。 


例 A-16 将 List<Employee> 映射 到 List<String> 
List<String> names = employees.stream() 
.map(Employee: :getName) 
.collect(toList()); 


List<String> strings = employees.stream() 
.map(Object: :toString) 
.Collect(toList()); 


可 以 看 到 ，Function 声明 了 两 个 泛 型 变量 ,分 别 用 于 输入 和 输出 。 在 第 一 个 代码 段 中 ，, 方 
法 引用 Employee: :getName 使 用 流 中 的 Employee 作为 输入 ， 并 返回 String 作为 输出 。 


在 第 二 个 代码 段 中 ， 由 于 通配符 super 的 缘故 ,程序 将 输入 变量 作为 object (而 非 
Employee) 的 方法 处 理 。 输 出 类 型 原则 上 可 以 是 包含 String 子 类 的 List,， 但 由 于 String 
被 声明 为 finaL， 不 存在 任何 子 类 。 


接 下 来 ， 我 们 讨论 Java 8 引入 的 部 分 方法 签名 。 




















A.5.3 Comparator .comparing 方 法 


例 A-15 使 用 了 Comparator 接口 定义 的 静态 方法 comparing。Comparator 接口 从 Java 1.0 起 
就 已 存在 ， 开 发 人 员 或 许 惊讶 于 该 接口 目前 包含 的 方法 是 如 此 之 多 。Java 8 将 函数 式 接 口 
定义 为 包含 单一 抽象 方法 (single abstract method) 的 接口 。Comparator 属于 函数 式 接口 ， 
所 包含 的 单一 抽象 方法 为 compare， 它 传 入 两 个 均 为 泛 型 类 型 T 的 参数 。 根 据 第 一 个 参数 
小 于 、 等 于 或 大 于 第 二 个 参数 ，compare 方法 将 分 别 返 回 负 整数 、0 或 正 整数 "。 





注 6: Java API 使 用 T 表 示 单 个 输入 变量 ， 或 T 和 1 表示 两 个 输入 变量 ， 以 此 类 推 。API 通常 使 用 R 表示 返 
可 变量 。 而 对 于 映射 ，API 使 用 K 表示 键 ，Vv 表 示 值 。 
注 7: 有 关 比 较 器 的 讨论 请 参见 范例 4.1。 
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而 comparing 方法 的 签名 如 下 : 


static <T,U extends Comparable<? super U>> Comparator<T> comparing( 
Function<? super T,? extends U> keyExtractor) 


观察 comparing 方法 的 参数 可 以 看 到 ， 其 名 称 为 keyExtractor， 类 型 为 Function。 与 之 前 
类 似 ，Function 定义 了 两 个 泛 型 类 型 ， 分 别 用 于 输入 和 输出 。 输 入 的 下 界 由 输入 类 型 T 指 
定 ， 而 输出 的 上 界 由 输出 类 型 U 指定 。 参 数 名 在 这 里 作为 键 使 用 : 国 数 采 用 某 种 方法 提取 
出 需要 排序 的 属性 ，comparing 方法 通过 返回 Comparator 来 完成 这 项 工作 。 


我 们 希望 使 用 给 定 属性 U 对 流 排序 ， 因 此 U 必须 实现 Comparable。 换 言 之， 在 声明 U 时 , U 
必须 要 继承 Comparable。 当 然 ，Comparable 本 身 是 一 种 类 型 化 接口 (typed interface) ， 其 
类 型 通常 为 U， 但 也 可 以 是 的 任何 超 类 。 

comparing 方法 最 终 返 回 的 是 Comparator<T>， 然 后 Stream 接口 定义 的 其 他 方法 使 用 
Comparator<T> 对 流 排序 ， 结 果 流 与 原始 流 的 类 型 相同 。 


comparing 方法 的 用 法 请 参见 例 A-15。 



































A.5.4 Map.Entry.comparingByKey 与 Map.Entry.comparingByVatLue 
方 ; 
最 后 ， 我 们 编写 程序 将 员工 添加 到 Map ( 键 为 员工 ID， 值 为 员工 姓名 ) ， 并 根据 ID 或 姓名 
进行 排序 ， 然 后 打印 结果 。 
第 一 步 是 将 员工 添加 到 Map。 借 由 静态 方法 Collectors.toMap， 只 需 一 行 代码 就 能 实现 : 
// 使 用 ID 作为 键 ， 将 员工 添加 到 映射 


Map<Integer, Employee> employeeMap = employees.stream() 
.Collect(Collectors.toMap(Employee: :getId, Function.identity())); 


toMap 方法 的 签名 如 下 : 


static <T, K, U> Collector<T, ?, Map<K, U>> toMap( 
Function<? super T,? extends K> keyMapper, 
Function<? super T,? extends U> valueMapper) 


Collectors 是 一 种 工具 类 ( 仅 包 含 静 态 方法 )， 提 供 Collector 接口 的 实现 。 


从 toMap 方法 的 签名 可 以 看 到 ， 它 传人 两 个 国 数 作为 参数 ， 一 个 用 于 生成 键 ， 另 一 个 用 于 
在 输出 映射 中 生成 值 。toMap 方法 的 返回 类 型 为 CoLLector， 它 定义 了 三 种 泛 型 参数 。 


根据 Javadoc 的 描述 ，Collector 接口 的 签名 如 下 : 
public interface Collector<T,A,R> 
三 种 泛 型 类 型 的 定义 如 下 。 


。 T: 归 约 操作 的 输入 元 素 类 型 ， 
。 A: 归 约 操作 的 可 变 累 加 类 型 (通常 隐藏 为 实现 细 市 ) ; 
。 R: 归 约 操作 的 结果 。 
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Employee: :getId 相当 于 toMap 方法 签名 中 的 keyMapper。 换 言 之 ，T 是 Integer; 而 结果 RR 
是 Map 接口 的 实现 ， 它 使 用 Integer 替换 K，Employee 替换 U。 


意思 的 是 ，Collector 接口 定义 中 的 变量 A 是 Map 接口 的 实际 实现 。 它 可 能 是 HashMap”， 
但 我 们 不 得 而 知 ， 因 为 结果 用 作 toMap 方法 的 参数 ， 无 法 被 观察 到 。 不 过 在 Collector 中 ， 
类 型 使 用 无 界 通配符 ?， 这 意味 着 类 型 在 内 部 要 么 仅 使 用 0bject 类 中 的 方法 ， 要 么 使 用 
Map 接口 中 不 特定 于 类 型 的 方法 。 实 际 上 ， 在 调用 keyMapper 和 valueMapper 函数 后 ， 类 型 
仅 使 用 Map 接口 新 增 的 默认 方法 merge。 
为 实现 排序 ，Java 8 为 Map.Entry 接口 引入 了 静态 方法 comparingByKey 和 comparingByValue。 
如 例 A-17 所 示 ， 程 序 根 据 键 对 映射 元 素 排序 ， 然 后 打印 结果 。 
例 A-17 根据 键 对 映射 元 素 排 序 并 打印 结果 


Map<Integer, Employee> employeeMap = employees.stream() 
.Collect(Collectors.toMap(Employee: :getId, Function.identity())); © 


























System.out.println("Sorted by key:"); 
employeeMap.entrySet().stream() 
.Sorted(Map.Entry.comparingByKey()) 
.forEach(entry -> { 
System.out.println(entry.getKey() + ": " + entry.getVaLue()); @ 
]); 


@ 使 用 ID 作为 键 ， 将 员工 添加 到 Map 
@ 根据 ID 对 员工 排序 ， 然 后 打印 结果 
comparingByKey 方法 的 签名 如 下 : 


static <K extends Comparable<? super K>,V> 
Comparator<Map.Entry<K,V>> comparingByKey() 


comparingByKey 方法 不 传 入 任何 参数 ， 它 返回 一 个 比较 Map.Entry 实例 的 Comparator。 由 
于 我 们 根据 键 比 较 员 工 姓 名 ， 键 K 的 声明 泛 型 类 型 必须 是 Comparable 的 子 类 型 ， 才 能 执行 
实际 的 比较 操作 。 当 然 ，Comparable 本 身 定义 了 泛 型 类 型 K 或 K 的 某 种 父 类 型 ， 这 意味 着 
compareTo 方法 可 以 使 用 K 类 (或 更 高 ) 的 属性 。 


根据 键 进行 排序 的 结果 如 下 : 


Sorted by key: 

1: Seth Curry 

2: Kevin Durant 
3: Draymond Green 
4: KLay Thompson 


根据 值 进行 排序 则 有 些 复 杂 。 如 果 不 了 解 泛 型 类 型 的 相关 知识 ， 就 很 难 理解 错误 的 成 因 。 
comparingByValue 方法 的 签名 如 下 : 


static <K,V extends Comparable<? Super V>> Comparator<Map.Entry<K,V>> 
comparingByValue() 
















































































注 8: 在 引用 实现 中 的 确 是 HashMap。 
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与 comparingByKey 方法 不 同 ， 在 comparingByValue 方法 中 ，V 必须 是 Comparable 的 子 类 型 。 
根据 值 排序 时 ， 很 容易 写 出 下 面 这 样 的 代码 : 


// 根据 员工 姓名 排序 ， 然 后 打印 结果 (无 法 编译 ) 
empLoyeeMap .entrySet() .stream() 
.sorted(Map.Entry.comparingByValue()) 
.forEach(entry -> { 
System.out.println(entry.getKey() + ": " + entry.getValue()); 


和 
不 过 代码 无 法 编译 ， 程 序 会 提示 错误 : 


Java: incompatible types: inference variable V has incompatible bounds 
equality constraints: generics.Employee 
upper bounds: java.lang.Comparable<? super V> 


原因 在 于 映射 中 的 值 是 Employee 的 实例 ， 但 Employee 并 未 实现 Comparable。 好 在 
comparingByValue 方法 还 包括 一 种 重 载 形式 .: 


static <K,V> Comparator<Map.Entry<K,V>> ComparingByVaLue( 
Comparator<? super V> cmp) 


comparingByValue 方法 传人 Comparator 作为 参数 ， 并 返回 一 个 新 的 Comparator， 它 根据 值 
比较 各 个 Map.Entry 元 素 。 对 映射 值 排序 的 正确 方式 如 例 A-18 所 示 。 


例 A-18 根据 值 对 映射 元 素 排序 并 打印 结果 


// 根据 员工 姓名 排序 ， 然 后 打印 结果 
System.out.printLn("Sorted by name:"); 
empLoyeeMap .entrySet() .stream() 
.Sorted(Map.Entry.comparingByVaLue(Comparator .comparing(Employee: :getName))) 
.forEach(entry -> { 
System.out.println(entry.getKey() + ": " + entry.getValue()); 
]); 


通过 为 comparing 方法 提供 方法 引用 Employee: :getNamne， 就 能 实现 按 员工 姓名 的 自然 顺序 
排序 : 


Sorted by name : 
3: Draymond Green 
2: Kevin Durant 
4: KLay Thompson 
1: Seth Curry 


希望 上 述 示例 能 提供 足够 的 背景 知识 ， 以 免 读 者 在 阅读 和 使 用 Java API 时 对 泛 型 感到 困 


A.5.5 ”类 型 擦 除 


使 用 Java 这 样 的 语言 开发 时 ， 如 何 保持 长 久 以 来 的 向 后 兼容 性 让 人 上 烦 费 脑筋 ， 开 发 团队 为 
此 做 了 不 少 努 力 。 以 泛 型 为 例 ， 与 泛 型 有 关 的 信息 将 在 编译 阶段 被 删除 ， 从 而 不 会 为 参数 
化 类 型 创建 新 的 类 ， 避 免 了 可 能 出 现 的 运行 时 错误 。 这 称 为 类 型 擦 除 (type erasure)。 


由 于 所 有 操作 均 在 后 台 完 成 ， 开 发 人 员 真 正 需要 了 解 的 是 在 编译 时 : 
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。 有 界 类 型 参数 被 替换 为 参数 边界 ; 

。 无 界 类 型 参数 被 替换 为 0bject; 

。 在 需要 时 插入 类 型 强制 转换 ， 

。 生成 桥接 方法 (bridge method) 以 保持 多 态 (polymorphism)。 

对 类 型 而 言 ， 结 果 相 当 简单 。Map 接口 定义 了 两 种 泛 型 类 型 ， 其 中 K 代表 键 ，V 代表 值 。 在 
实例 化 Map<Integer ,Employee> 时 ， 编 译 器 分 别 用 Integer 和 EmpLoyee 替换 K 和 V。 

从 Map.Entry.comparingByKey 方法 的 签名 可 以 看 到 ， 键 被 声明 为 K extends Comparable， 
这 使 得 类 中 所 有 出 现 的 K 都 会 被 替换 为 Comparable。 


Function 接口 定义 了 两 种 泛 型 类 型 T 和 R， 所 包含 的 单一 抽象 方法 为 : 

R appLy(T t) 
从 Stream.map 方法 的 签名 可 以 看 到 ， 其 边界 为 Function<? super T,? extends R>。 观 察 
例 A-16 中 的 map 方法 : 


List<String> names = employees.stream() 
.map(EmpLoyee: :getName) 
.collect(Collectors. toList()); 
Function 采用 Employee 替换 T (因为 这 是 一 个 由 员工 构成 的 流 )， 采 用 String 替换 R ( 因 
为 getName 的 返回 类 型 为 String)。 


关于 类 型 擦 除 的 讨论 大 致 如 此 ， 但 某 些 极端 情况 并 未 考虑 在 内 。 感 兴趣 的 读者 可 以 参考 
Java 官方 教程 (Java Tutorials) ， 不 过 类 型 探 除 或 许 是 所 有 技术 中 最 简单 的 概念 。 


A.6 小 结 

Java 1.5 引入 的 泛 型 概念 目前 依然 存在 ， 不 过 随 着 Java 8 的 兴起 ， 相 应 的 方法 签名 变 得 更 
为 复杂 。 在 Java 中 ， 大 部 分 国 数 式 接 口 同 时 使 用 谤 型 类 型 和 有 界 通配符 以 强化 类 型 安全 。 
希望 读者 能 通过 本 附录 了 解 泛 型 的 基础 知识 ， 从 而 在 实际 开发 中 正确 应 用 API。 
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封面 介绍 

本 书 封 面 上 的 动物 是 水 庵 (sambar， 学 名 : Rusa unicolor) ， 这 是 一 种 原 产 于 南亚 的 大 型 庚 
种 ， 往 往 聚 集 在 河流 附近 。 成 年 水 谭 的 肩 高 为 40 到 63 英寸 (102 到 160 厘米 ) ， 体 重 一 般 
为 200 到 700 磅 (91 到 318 千克 )， 雄 鹿 的 体型 明显 大 于 肉 独 。 水 谭 是 继 廉 放 和 驼 谭 之 后 
现存 的 第 三 大 询 种 。 

水 席 主 要 在 黄 红 或 夜间 活动 ， 族 群 的 规模 通常 较 小 。 雄 席 在 一 年 的 大 部 分 时 间 里 喜欢 独居 ， 而 
最 小 的 坎 放 群体 可 能 只 有 三 只 。 较 之 其 他 谭 种 ， 水 询 表 现 出 更 强 的 双 足 能 力 ， 可 以 吃 到 更 高 的 
枝叶 并 标记 领地 ， 也 能 对 捕食 者 产生 威吓 。 峻 性 水 鹿 保 护 幼 屿 的 能 力 在 所 有 席 种 中 无 出 其 右 ， 
它们 更 喜欢 借助 水 域 来 保护 自己 ， 因 为 在 水 中 能 有 效 发 挥 身高 优势 以 及 强大 的 游泳 能 

2008 年 ， 世 界 自然 保护 联盟 濒危 物种 红色 名 录 (IUCN Red List) 将 水 庭 列 入 “ 易 危 ” 物 
种 。 雄 谭 放 角 因 适合 作为 战利品 与 传统 药材 而 备 受 追 搓 ,这 导致 了 对 水 谭 的 过 度 捕猎 ; 加 
之 工农 业 发 展 对 其 栖息 地 的 侵蚀 ， 使 得 水 谭 数 量 在 全 球 范围 内 呈 下 降 趋 执 。 然 而 ， 尽 管 亚 
洲 的 水 询 种 群 在 持续 减少 ， 但 从 19 世纪 后 期 水 许 进 入 新 西 兰 和 澳大利亚 以 来 ， 其 数量 却 
在 稳步 增长 ， 目 前 已 在 一 定 程度 上 对 当地 的 濒危 植物 物种 构成 了 威胁 。 

O’Reilly Media 图 书 封面 上 的 不 少 动物 都 濒临 灭绝 ， 所 有 动物 对 我 们 的 世界 都 至 关 重 要 。 
如 果 读 者 希望 了 解 如 何 为 拯救 濒危 物种 贡献 自己 的 力量 ， 请 访问 The O’Reilly Animals 。 

本 书 封面 图 片 取 自 Richard Lydekker 编著 的 The Royal Natural History。 














注 1: 全 美 第 二 大 Java 技术 大 会 。DevNexus 2018 于 2018 年 2 月 21 日 至 23 日 在 亚特兰大 举行 ， 包 括 近 20 
场 主题 演讲 与 研讨 会 ,涵盖 Java、JVM 语言、 架构、 框架、 安全、 性能、 移动 开发 、 云 计算 、 微 服务 、 
FaaS、 敏 捷 开发 等 各 个 领域 。 译 者 注 

注 2: 旨 在 推广 Groovy 的 技术 大 会 ， 为 世界 各 地 的 Groovy 开发 人 员 提 供 相 互 交 流 的 平台 。GR8Conf 目前 
包括 三 场 会 议 , 分别 在 美国 (GR8Conf US)、 丹麦 (GR8Conf Europe) 与 印度 (GR8Conf India) 举行 。 

译 者 注 

注 3: 由 参 会 人 员 评 选 出 的 “明星 演讲 者 "， 旨 在 表彰 他 们 为 社区 和 JavaOne 大 会 所 做 的 贡献 。Kousen 以 
Groovy and Java 8: Making Java Better (2016 年 ) 和 Making Java Groovy (2013 年 ) 为 题 的 演讲 获得 

当年 的 JavaOne Rock Star 大 奖 。 译 者 注 

注 4: 伦 斯 勒 理工 学 院 简 称 RPI， 建 于 1824 年 ， 是 英语 国家 历史 最 悠久 的 理工 科大 学 ， 美 国 25 所 “新 常春 
茧 盟 校 ”(New Ivies) 之 一 。 一 一 译 者 注 
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